在Java里如何统一处理异常_全局异常处理方案解析

P粉602998670 2025-12-29 00:00:00 次阅读

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, "系统繁忙，请稍后再试");
  }
}