Как глобально обрабатывать исключения с @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Вместо оборачивания каждого метода контроллера в try/catch Spring позволяет централизовать обработку ошибок в одном классе, аннотированном `@ControllerAdvice` (или `@RestControllerAdvice`). Методы, помеченные `@ExceptionHandler`, перехватывают исключения, брошенные в любом месте ваших контроллеров, и превращают их в согласованные HTTP-ответы.

## Глобальный обработчик

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

// Перехватывает это исключение из ЛЮБОГО контроллера и возвращает 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Сбои валидации (@Valid) бросают это — превращаем ошибки полей в 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);
    }
}
```

Теперь любой контроллер может просто `throw new EntityNotFoundException(...)` и доверить advice формирование ответа.

## Современный вариант: ProblemDetail

Spring 6 / Boot 3 поставляют RFC 9457 `ProblemDetail` — стандартизированное тело ошибки:

```java
@ExceptionHandler(PaymentDeclinedException.class)
public ProblemDetail declined(PaymentDeclinedException ex) {
    var pd = ProblemDetail.forStatusAndDetail(HttpStatus.PAYMENT_REQUIRED, ex.getMessage());
    pd.setTitle("Payment declined");
    return pd; // сериализуется как application/problem+json
}
```

## Почему это важно

Согласованные, машиночитаемые ответы об ошибках — это то, что отличает профессиональный API от того, который сливает stack traces. Интервьюеры хотят видеть, что вы централизуете обработку (DRY), сопоставляете исключения с *правильными* кодами статуса и никогда не раскрываете внутренние детали клиентам. Упоминание `ProblemDetail` показывает, что вы в курсе Boot 3.

Глобальный обработчик

Современный вариант: ProblemDetail

Почему это важно

Похожие вопросы