前言
在实际开发中，业务逻辑异常（如余额不足、权限受限）或系统异常（如空指针、数据库连接超时）无处不在。如果任由异常向上抛出，前端将会接收到含糊的 500 错误或敏感的代码堆栈信息。
我们不需要在每个 Controller 方法中写 try-catch，而是通过 @RestControllerAdvice 建立一套全局拦截机制，将所有捕获到的异常，统一转化为上一篇定义的 Result 响应体返回。
定义业务异常类
对于业务类异常，我们需要明确告知调用方具体的错误编码和提示信息。因此，在自定义业务异常（BusinessException）时，必须包含 code 字段，而 message 则直接复用父类 RuntimeException 的消息体系。
核心逻辑：
- code：对应
Result实体中的业务状态码，用于前端逻辑判断。 - message：描述具体的异常原因，用于前端友好提示。
通过这种方式，我们可以将异常直接转化为标准化的 Result 响应。
这里我们用到上一节定义的 ResultCode 相关类来构建业务异常，# 手把手带你封装生产级 Result 实体
@Getter
public class BusinessException extends RuntimeException {
private final int code;
/**
* 使用默认错误码(1)构造
*
* @param message 错误信息
*/
public BusinessException(String message) {
super(message);
this.code = CommonResultCode.BUSINESS_ERROR.getCode();
}
/**
* 使用结果码接口构造
*
* @param resultCode 结果码接口
*/
public BusinessException(ResultCode resultCode) {
super(resultCode.getMessage());
this.code = resultCode.getCode();
}
/**
* 使用结果码接口构造，但覆盖错误信息
*
* @param resultCode 结果码接口
* @param message 错误信息
*/
public BusinessException(ResultCode resultCode, String message) {
super(message);
this.code = resultCode.getCode();
}
/**
* 指定错误码构造
*
* @param code 错误码
* @param message 错误信息
*/
public BusinessException(int code, String message) {
super(message);
this.code = code;
}
/**
* 包装其他异常
*
* @param message 错误信息
* @param cause 原始异常
*/
public BusinessException(String message, Throwable cause) {
super(message, cause);
this.code = CommonResultCode.BUSINESS_ERROR.getCode();
}
}
全局异常处理器
定义好业务异常后，要使其能正常工作，需要配合全局异常处理器一起使用。在全局异常处理其中，除了普通的业务异常外，还要包含其他的如校验、服务器异常、404 等异常的处理：
@Slf4j
@RestControllerAdvice
public class GlobalExceptionHandler {
/**
* 处理业务异常
*/
@ExceptionHandler(BusinessException.class)
public Result<Void> handleBusinessException(BusinessException e, HttpServletRequest request) {
log.warn("业务异常: {} {}", request.getRequestURI(), e.getMessage());
return Result.of(e.getCode(), e.getMessage(), null);
}
/**
* 处理参数校验异常 (JSON Body)
*/
@ExceptionHandler(MethodArgumentNotValidException.class)
public Result<Void> handleMethodArgumentNotValidException(MethodArgumentNotValidException e,
HttpServletRequest request) {
String message = this.buildBindingResultMsg(e.getBindingResult());
log.warn("参数校验异常: {} {}", request.getRequestURI(), message);
return Result.of(CommonResultCode.PARAM_ERROR.getCode(), message, null);
}
/**
* 处理参数绑定异常 (Form Data)
*/
@ExceptionHandler(BindException.class)
public Result<Void> handleBindException(BindException e, HttpServletRequest request) {
String message = this.buildBindingResultMsg(e.getBindingResult());
log.warn("参数绑定异常: {} {}", request.getRequestURI(), message);
return Result.of(CommonResultCode.PARAM_ERROR.getCode(), message, null);
}
/**
* 处理 404 异常
* 需要配置: spring.mvc.throw-exception-if-no-handler-found=true
*/
@ExceptionHandler(NoHandlerFoundException.class)
public Result<Void> handleNoHandlerFoundException(NoHandlerFoundException e, HttpServletRequest request) {
log.warn("接口不存在: {} {}", request.getMethod(), request.getRequestURI());
return Result.of(CommonResultCode.NOT_FOUND);
}
/**
* 处理请求方法不支持异常
*/
@ExceptionHandler(HttpRequestMethodNotSupportedException.class)
public Result<Void> handleHttpRequestMethodNotSupportedException(HttpRequestMethodNotSupportedException e,
HttpServletRequest request) {
log.warn("请求方法不支持: {} {}, 支持的方法: {}", request.getMethod(), request.getRequestURI(),
e.getSupportedHttpMethods());
return Result.of(CommonResultCode.METHOD_NOT_ALLOWED);
}
/**
* 处理兜底异常
*/
@ExceptionHandler(Exception.class)
public Result<Void> handleException(Exception e, HttpServletRequest request) {
log.error("系统异常: " + request.getRequestURI(), e);
return Result.of(CommonResultCode.SYSTEM_ERROR);
}
private String buildBindingResultMsg(BindingResult result) {
return result.getFieldErrors().stream()
.map(FieldError::getDefaultMessage)
.collect(Collectors.joining("; "));
}
}
有了这些配置，我们在业务中就可以通过抛异常的方式处理业务异常了！
