Java 中怎么在 Controller 层统一拦截自定义异常-java教程-PHP中文网

统一异常处理应使用@RestControllerAdvice配合@ExceptionHandler，而非在Controller内try-catch；自定义BizException继承RuntimeException并含code/msg字段，Controller直接throw，全局处理器返回标准Result，支持多异常分类处理且需确保异常类不重写getMessage()、类被Spring扫描到。

java 中怎么在 controller 层统一拦截自定义异常

Controller 层本身不负责“拦截”异常，而是抛出异常；真正统一拦截自定义异常的位置是 @ControllerAdvice 类，配合 @ExceptionHandler 方法。这是 Spring Boot 官方推荐、最稳定且可维护的方式。

为什么不能在 Controller 里“统一拦截”？

每个 Controller 方法都是独立入口，若在每个方法里写 try-catch 处理 BizException，会严重重复、难以维护，也违背关注点分离原则。统一处理必须脱离单个 Controller，上升到全局层面。

标准做法：用 @RestControllerAdvice 捕获自定义异常

定义一个全局异常处理器类，标注 @RestControllerAdvice（等价于 @ControllerAdvice + @ResponseBody），专门响应你定义的业务异常：

自定义异常类继承 RuntimeException，带 code 和 msg 字段，例如：
public class BizException extends RuntimeException { private int code = 400; public BizException(int code, String msg) { super(msg); this.code = code; } }
在 Controller 中直接 throw new BizException(403, "权限不足"); —— 不需要 try-catch
在 @RestControllerAdvice 类中用 @ExceptionHandler(BizException.class) 捕获并返回标准 Result：

@RestControllerAdvice
public class GlobalExceptionHandler {
  @ExceptionHandler(BizException.class)
  public Result handleBiz(BizException e) {
    return Result.fail(e.getCode(), e.getMessage());
  }
}

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载