java 中通过实现 handlerexceptionresolver 接口或添加 @controlleradvice 注解的类来统一处理异常。具体做法是定义一个全局异常处理器,使用 @exceptionhandler 捕获特定异常并返回统一的 json 响应结构,从而避免在每个 controller 方法中重复编写 try-catch 块。

如何定义全局异常处理器类?
需要创建一个被 Spring 管理的组件类,并使用 @RestControllerAdvice 或 @ControllerAdvice 注解标记该类。在类内部定义方法,使用 @ExceptionHandler 指定要捕获的异常类型,该方法将作为异常的入口点。

import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.http.ResponseEntity;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(Exception.class)
public ResponseEntity<map object>> handleAllExceptions(Exception ex) {
Map<string object> body = new HashMap();
body.put("status", 500);
body.put("message", "系统内部错误: " + ex.getMessage());
return ResponseEntity.status(500).body(body);
}
}</string></map>
上述代码定义了一个名为 GlobalExceptionHandler 的类。它使用了 @RestControllerAdvice,这意味着它会自动扫描所有 Controller 中的异常。当任何 Controller 抛出 Exception 或其子类时,handleAllExceptions 方法会被调用。该方法构建了一个包含状态码和错误信息的 Map,并通过 ResponseEntity 将其序列化为 JSON 返回给客户端。如果希望区分业务异常和系统异常,可以添加多个 @ExceptionHandler 方法来处理不同的异常类型,例如 BusinessException。
如何处理自定义业务异常?
在处理自定义业务异常时,应定义专门的异常类并在全局处理器中单独捕获。这样可以为业务逻辑错误提供更具描述性的错误信息,而不是通用的系统错误消息。
使用 Husky 将 pre-commit、pre-push 和 commit-msg 检查集成到仓库中,以便代理和开发人员在更改离开工作站之前运行相同的本地防护措施。

public class BusinessException extends RuntimeException {
private int code;
public BusinessException(int code, String message) {
super(message);
this.code = code;
}
public int getCode() { return code; }
}
// 在 GlobalExceptionHandler 中添加:
@ExceptionHandler(BusinessException.class)
public ResponseEntity<map object>> handleBusinessException(BusinessException ex) {
Map<string object> body = new HashMap();
body.put("status", ex.getCode());
body.put("message", ex.getMessage());
return ResponseEntity.status(ex.getCode()).body(body);
}</string></map>
首先定义 BusinessException 类,它继承自 RuntimeException 并包含一个业务状态码 code。在全局异常处理器中,添加一个新的 @ExceptionHandler 方法来专门处理 BusinessException。这个方法会提取异常中的 code 和 message,并将它们放入响应体中。由于 Spring 的异常处理机制是按优先级匹配的,更具体的异常(如 BusinessException)会优先于通用异常(如 Exception)被处理。这样,当 Controller 抛出 new BusinessException(400, "参数错误") 时,客户端将收到 HTTP 400 状态码和对应的错误信息,而不是默认的 500 错误。
全局异常处理器对未捕获异常的行为是什么?
全局异常处理器对于未被任何 @ExceptionHandler 明确捕获的异常,会回退到最通用的 Exception 处理方法。如果连通用的 Exception 处理也未配置,Spring Boot 会默认返回其内置的错误页面或 JSON 响应。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










