Что такое глобальный обработчик исключений (Global Exception Handler) в Spring?

«Что такое глобальный обработчик исключений (Global Exception Handler) в Spring?» — вопрос из категории Spring, который задают на 10% собеседований Java Разработчик. Ниже — развёрнутый ответ с разбором ключевых моментов.

Ответ

Глобальный обработчик исключений (Global Exception Handler) в Spring — это централизованный механизм для перехвата и обработки исключений, выброшенных в любом месте приложения (обычно в контроллерах), до того как они достигнут клиента. Это позволяет отделить логику обработки ошибок от бизнес-логики и возвращать структурированные, согласованные HTTP-ответы.

Реализация с помощью @ControllerAdvice: Создаётся специальный класс, аннотированный @ControllerAdvice (или @RestControllerAdvice для REST API), содержащий методы, аннотированные @ExceptionHandler.

Пример:

@RestControllerAdvice
public class GlobalExceptionHandler {

    // Обработка конкретного исключения
    @ExceptionHandler(ResourceNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ErrorResponse handleResourceNotFound(ResourceNotFoundException ex) {
        return new ErrorResponse("NOT_FOUND", ex.getMessage());
    }

    // Обработка всех неперехваченных исключений
    @ExceptionHandler(Exception.class)
    @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
    public ErrorResponse handleAllUncaughtException(Exception ex) {
        return new ErrorResponse("INTERNAL_ERROR", "An unexpected error occurred");
    }
}

// DTO для ответа с ошибкой
class ErrorResponse {
    private String code;
    private String message;
    // конструкторы, геттеры, сеттеры
}

Преимущества:

  • Единая точка обработки: Убирает дублирование try-catch блоков в контроллерах.
  • Согласованный формат ответов: Все ошибки возвращаются в одном формате (JSON, XML).
  • Гибкость: Можно назначать разные HTTP-статусы, логировать ошибки, выбирать @ControllerAdvice для конкретных пакетов или классов контроллеров.