17370845950

Java统一异常处理的核心是@ControllerAdvice配合@ExceptionHandler，结合自定义异常类与Result响应体，实现异常集中捕获、分类处理和标准化返回。

Java中统一处理异常的核心是用@ControllerAdvice配合@ExceptionHandler，结合自定义异常类和统一响应结构，让所有Controller层抛出的异常都能被集中捕获、分类处理并返回标准化结果。

定义统一响应体

先设计一个通用的返回格式，包含状态码、消息、时间戳和可选数据：

  public class Result {
    private int code;
    private String message;
    private long timestamp;
    private T data;
    // 构造方法、getter/setter省略
}

这样前后端交互时，无论成功还是失败，结构都一致，前端容易统一解析。

创建业务自定义异常

避免直接抛出RuntimeException或Exception，而是按场景定义具体异常类型：

• BusinessException：业务校验失败，如参数不合法、余额不足
• ResourceNotFoundException：查不到数据，对应HTTP 404
• UnauthorizedException：权限不足，对应HTTP 401

每个异常可携带code和message，便于在全局处理器中映射状态码和提示语。

编写全局异常处理器

使用@ControllerAdvice声明为全局通知类，用@ExceptionHandler指定处理哪些异常：

@ControllerAdvice
public class GlobalExceptionHandler {

  @ExceptionHandler(BusinessException.class)
  @ResponseBody
  public Result handleBusinessException(BusinessException e) {
    return Result.fail(e.getCode(), e.getMessage());
  }

  @ExceptionHandler(ResourceNotFoundException.class)
  @ResponseStatus(HttpStatus.NOT_FOUND)
  @ResponseBody
  public Result handleNotFound(ResourceNotFoundException e) {
    return Result.fail(404, e.getMessage());
  }

  @ExceptionHandler(Exception.class)
  @ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
  @ResponseBody
  public Result handleUnexpected(Exception e) {
    log.error("未预期异常", e);
    return Result.fail(500, "系统繁忙，请稍后再试");
  }
}

注意顺序：子类异常处理器要写在父类前面，否则会被更宽泛的Exception拦截掉。

补充：整合Spring Boot Actuator与日志追踪

生产环境建议搭配以下实践提升可观测性：

• 在异常处理器中记录异常堆栈（但敏感信息如密码、密钥需脱敏）
• 引入MDC，在请求入口注入traceId，让日志带上下文标识
• 配合Actuator的/actuator/error端点（默认开启），确保容器级错误也能被捕获
• 若用WebFlux，改用@ControllerAdvice + @ExceptionHandler + Mono/Flux响应方式

不复杂但容易忽略。