Jak obsługiwać wyjątki globalnie za pomocą @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Zamiast owijać każdą metodę kontrolera w try/catch, Spring pozwala scentralizować obsługę błędów w jednej klasie oznaczonej `@ControllerAdvice` (lub `@RestControllerAdvice`). Metody oznaczone `@ExceptionHandler` przechwytują wyjątki rzucone gdziekolwiek w twoich kontrolerach i zamieniają je w spójne odpowiedzi HTTP.

## Globalny 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);
    }
}
```

Każdy kontroler może teraz po prostu `throw new EntityNotFoundException(...)` i ufać, że advice ukształtuje odpowiedź.

## Nowoczesna opcja: ProblemDetail

Spring 6 / Boot 3 dostarczają `ProblemDetail` zgodny z RFC 9457 — ustandaryzowaną treść błędu:

```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
}
```

## Dlaczego to ważne

Spójne, maszynowo czytelne odpowiedzi błędów odróżniają profesjonalne API od takiego, które wycieka stack trace. Rekruterzy chcą zobaczyć, że centralizujesz obsługę (DRY), mapujesz wyjątki na *właściwe* kody statusu i nigdy nie ujawniasz klientom wewnętrznych szczegółów. Wspomnienie o `ProblemDetail` pokazuje, że jesteś na bieżąco z Boot 3.

Globalny handler

Nowoczesna opcja: ProblemDetail

Dlaczego to ważne

Powiązane pytania