@ControllerAdvice로 예외를 전역적으로 어떻게 처리하나요?

Question

IT Interview Practice · Accepted Answer

모든 컨트롤러 메서드를 try/catch로 감싸는 대신, Spring은 `@ControllerAdvice`(또는 `@RestControllerAdvice`)가 붙은 하나의 클래스에 오류 처리를 집중시킬 수 있게 합니다. `@ExceptionHandler`가 붙은 메서드는 컨트롤러 어디서든 던져진 예외를 잡아 일관된 HTTP 응답으로 바꿉니다.

## 전역 핸들러

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

이제 어떤 컨트롤러든 그냥 `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; // serialized as application/problem+json
}
```

## 왜 중요한가

일관되고 기계가 읽을 수 있는 오류 응답이 전문적인 API와 스택 트레이스를 흘리는 API를 가릅니다. 면접관은 여러분이 처리를 집중화(DRY)하고, 예외를 *올바른* 상태 코드에 매핑하며, 내부 세부 정보를 클라이언트에 절대 노출하지 않는 것을 보고 싶어 합니다. `ProblemDetail`을 언급하는 것은 Boot 3에 밝다는 것을 보여 줍니다.

전역 핸들러

현대적 선택지: ProblemDetail

왜 중요한가

관련 질문