@ControllerAdvice ile hataları global olarak nasıl yönetirsiniz?

Question

IT Interview Practice · Accepted Answer

Her controller metodunu try/catch içine sarmak yerine, Spring hata yönetimini `@ControllerAdvice` (veya `@RestControllerAdvice`) ile anotasyonlanmış tek bir sınıfta merkezileştirmenize olanak tanır. `@ExceptionHandler` ile işaretlenmiş metotlar, controller'larınızın herhangi bir yerinde fırlatılan istisnaları yakalar ve bunları tutarlı HTTP yanıtlarına dönüştürür.

## Global bir handler

```java
@RestControllerAdvice // = @ControllerAdvice + @ResponseBody
public class GlobalExceptionHandler {

// Catches this exception from ANY controller and returns 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Validation failures (@Valid) throw this — turn field errors into 400.
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ApiError invalid(MethodArgumentNotValidException ex) {
        String msg = ex.getBindingResult().getFieldErrors().stream()
            .map(e -> e.getField() + " " + e.getDefaultMessage())
            .collect(Collectors.joining(", "));
        return new ApiError("VALIDATION", msg);
    }
}
```

Artık herhangi bir controller sadece `throw new EntityNotFoundException(...)` yapabilir ve advice'ın yanıtı şekillendireceğine güvenebilir.

## Modern seçenek: ProblemDetail

Spring 6 / Boot 3, standartlaştırılmış bir hata gövdesi olan RFC 9457 `ProblemDetail`'i getirir:

```java
@ExceptionHandler(PaymentDeclinedException.class)
public ProblemDetail declined(PaymentDeclinedException ex) {
    var pd = ProblemDetail.forStatusAndDetail(HttpStatus.PAYMENT_REQUIRED, ex.getMessage());
    pd.setTitle("Payment declined");
    return pd; // serialized as application/problem+json
}
```

## Neden önemli

Tutarlı, makine tarafından okunabilir hata yanıtları, profesyonel bir API'yi stack trace sızdıran bir API'den ayıran şeydir. Mülakatçılar, yönetimi merkezileştirdiğinizi (DRY), istisnaları *doğru* durum kodlarına eşlediğinizi ve dahili ayrıntıları asla istemcilere açığa çıkarmadığınızı görmek ister. `ProblemDetail`'den bahsetmek, Boot 3 ile güncel olduğunuzu gösterir.

Global bir handler

Modern seçenek: ProblemDetail

Neden önemli

İlgili sorular