Spring Boot @ControllerAdvice与@ExceptionHandler

@ControllerAdvice配合@ExceptionHandler是Spring MVC提供的全局异常处理方案，实现跨Controller的统一异常捕获。

@ControllerAdvice注解

基本用法

@ControllerAdvice
public class GlobalExceptionHandler {
    // 全局异常处理方法
}

限定作用范围

// 限定Controller包路径
@ControllerAdvice("com.example.web")

// 限定注解类型
@ControllerAdvice(annotations = RestController.class)

// 限定具体类
@ControllerAdvice(assignableTypes = {UserController.class, OrderController.class})

@ExceptionHandler注解

基本用法

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(RuntimeException.class)
    public ResponseEntity<String> handleRuntimeException(RuntimeException e) {
        return ResponseEntity.status(500).body(e.getMessage());
    }

    @ExceptionHandler({NullPointerException.class, IllegalArgumentException.class})
    public ResponseEntity<String> handleMulti(Exception e) {
        return ResponseEntity.badRequest().body(e.getMessage());
    }
}

方法签名

// 支持的参数类型
@ExceptionHandler(Exception.class)
public ResponseEntity<String> handle(
    Exception e,                    // 异常对象
    HttpServletRequest request,     // 请求对象
    HttpServletResponse response,   // 响应对象
    WebRequest webRequest          // Web请求对象
) { ... }

// 支持的返回类型
@ExceptionHandler(Exception.class)
public String handle(Exception e, Model model) { return "error"; }  // 视图名

@ExceptionHandler(Exception.class)
@ResponseBody
public Result handle(Exception e) { return Result.fail(e.getMessage()); }  // JSON

@ExceptionHandler(Exception.class)
public ResponseEntity<Result> handle(Exception e) { return ResponseEntity.ok(Result.fail()); }

@RestControllerAdvice

@RestControllerAdvice = @ControllerAdvice + @ResponseBody

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(Exception.class)
    public Result handle(Exception e) {
        return Result.fail(e.getMessage());  // 自动序列化为JSON
    }
}

异常匹配规则

同一异常只能被一个@ExceptionHandler方法处理，优先匹配最具体的异常类型。

要点总结

• @ControllerAdvice定义全局异常处理类
• @ExceptionHandler标注异常处理方法
• @RestControllerAdvice等同于@ControllerAdvice+@ResponseBody
• 可通过属性限定作用范围
• 异常匹配遵循最近父类原则