Jak zpracovávat výjimky globálně pomocí @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Místo obalování každé metody controlleru do try/catch umožňuje Spring centralizovat zpracování chyb do jedné třídy anotované `@ControllerAdvice` (nebo `@RestControllerAdvice`). Metody označené `@ExceptionHandler` zachytí výjimky vyhozené kdekoli ve vašich controllerech a promění je v konzistentní HTTP odpovědi.

## Globální handler

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

// Zachytí tuto výjimku z JAKÉHOKOLI controlleru a vrátí 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Selhání validace (@Valid) vyhodí toto — proměň field errors na 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);
    }
}
```

Kterýkoli controller teď může jen `throw new EntityNotFoundException(...)` a spolehnout se, že advice odpověď zformuje.

## Moderní varianta: ProblemDetail

Spring 6 / Boot 3 přinášejí `ProblemDetail` dle RFC 9457, standardizované tělo chyby:

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

## Proč je to důležité

Konzistentní, strojově čitelné chybové odpovědi jsou to, co odděluje profesionální API od takového, které prosakuje stack traces. Tazatelé chtějí vidět, že zpracování centralizujete (DRY), mapujete výjimky na *správné* stavové kódy a nikdy klientům nevystavujete interní detaily. Zmínka o `ProblemDetail` ukazuje, že jste v obraze s Bootem 3.

Globální handler

Moderní varianta: ProblemDetail

Proč je to důležité

Související otázky