如何用 @ControllerAdvice 进行全局异常处理？

Question

IT Interview Practice · Accepted Answer

与其把每个 controller 方法都用 try/catch 包起来，Spring 让你把错误处理集中到一个标注了 `@ControllerAdvice`（或 `@RestControllerAdvice`）的类里。标注了 `@ExceptionHandler` 的方法会捕获你的 controller 中任何地方抛出的异常，并把它们变成一致的 HTTP 响应。

## 一个全局处理器

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

// 从任意 controller 捕获这个异常并返回 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);
    }
}
```

现在任何 controller 都可以直接 `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 与泄露堆栈跟踪的 API 之间的区别。面试官想看到你集中处理（DRY）、把异常映射到*正确的*状态码，并且绝不向客户端暴露内部细节。提到 `ProblemDetail` 说明你紧跟 Boot 3。

一个全局处理器

现代选择：ProblemDetail

为什么这很重要

相关问题