java 自定义异常通过全局异常处理器捕获,核心做法是定义继承自 runtimeexception 的异常类,并在配置类中注册 @controlleradvice 组件。该组件配合 @exceptionhandler 注解,能自动拦截控制器层抛出的特定异常,并统一返回 json 响应。这样无需在每个方法中手动 try-catch,即可实现异常的集中处理与标准化输出。

如何定义可被全局捕获的自定义异常
要使用全局异常处理器,首先需要创建一个自定义异常类。该类必须继承自 RuntimeException,以确保它是非检查型异常,从而在代码中不需要强制声明抛出。通常建议包含一个错误码和错误消息字段,以便后续在处理器中区分不同业务场景的错误。

package com.example.exception;
public class BusinessException extends RuntimeException {
private final int code;
public BusinessException(int code, String message) {
super(message);
this.code = code;
}
public int getCode() {
return code;
}
}
上述代码定义了一个名为 BusinessException 的类。它继承了 RuntimeException,因此在使用时无需显式 throws。构造函数接收一个整型 code 和一个字符串 message。这个设计允许调用者在抛出异常时携带具体的业务状态码,例如 400 表示参数错误,500 表示内部逻辑错误。这是全局处理器能够精准识别并分类处理的基础。
立即学习“Java免费学习笔记(深入)”;
如何配置全局异常处理器
接下来需要编写一个全局异常处理类。该类必须标注 @RestControllerAdvice(或 @ControllerAdvice),使其成为 Spring Boot 应用中的全局切面。在类内部,使用 @ExceptionHandler 注解指定要处理的异常类型。当控制器抛出该类型异常时,Spring 会自动调用对应的方法。

package com.example.config;
import com.example.exception.BusinessException;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public ResponseEntity<Result> handleBusinessException(BusinessException ex) {
Result result = new Result(ex.getCode(), ex.getMessage());
return ResponseEntity.status(200).body(result); // 假设业务层统一返回200,内容由code决定
}
}
class Result {
private int code;
private String message;
public Result(int code, String message) {
this.code = code;
this.message = message;
}
}
这段代码展示了 GlobalExceptionHandler 的实现。它使用了 @RestControllerAdvice,意味着它会自动扫描所有 Controller 层的异常。方法 handleBusinessException 被 @ExceptionHandler(BusinessException.class) 标记,专门处理 BusinessException。当任何 Controller 抛出此异常时,该方法会被触发。它从异常对象中提取 code 和 message,封装进 Result 对象,并通过 ResponseEntity 返回。这里为了演示清晰,HTTP 状态码固定为 200,实际项目中可根据 code 动态设置 HTTP 状态码(如 400 或 500)。
基于输入条件验证失败的具体问题
在实际开发中,最常见的触发场景是参数校验失败。例如,当用户提交的用户名长度为空时,程序应抛出 BusinessException。全局处理器会捕获该异常,并返回标准化的错误信息。这种机制确保了无论业务逻辑多复杂,前端收到的错误格式始终一致。


















