在 spring boot 应用中，使用 @exceptionhandler 的核心做法是创建一个被 @controlleradvice 或 @restcontrolleradvice 标注的全局异常处理类，并在其中定义处理特定异常的方法。当控制器抛出指定类型的异常时，spring 会自动拦截并调用该方法，从而返回统一的错误响应（如 json）或渲染特定的错误页面，避免将堆栈信息直接暴露给客户端。
如何捕获自定义业务异常并返回 JSON 响应
要捕获自定义的业务异常并返回 JSON，需要定义一个继承自 RuntimeException 的异常类，并在全局处理器中编写对应的方法。该方法需使用 @ResponseBody 注解（若使用 @RestControllerAdvice 则自动包含），并返回封装好的错误对象。这样，当业务逻辑抛出该异常时，前端会收到结构化的错误信息而非默认的 500 错误页。
package com.example.demo;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;
import java.util.HashMap;
import java.util.Map;
// 1. 定义自定义异常
class BusinessException extends RuntimeException {
private final String code;
public BusinessException(String code, String message) {
super(message);
this.code = code;
}
public String getCode() { return code; }
}
// 2. 定义全局异常处理器
@RestControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BusinessException.class)
public Map<String, Object> handleBusinessException(BusinessException ex) {
Map<String, Object> body = new HashMap<>();
body.put("status", "error");
body.put("code", ex.getCode());
body.put("message", ex.getMessage());
return body;
}
// 3. 模拟触发异常的 Controller
@GetMapping("/trigger")
public String triggerError() {
throw new BusinessException("4001", "User not found");
}
}
运行上述代码，访问 /trigger 接口，预期结果为 HTTP 状态码 200（因为我们在 handler 中手动构建了响应），响应体内容为：
{"status":"error","code":"4001","message":"User not found"}。注意，如果未使用 @RestControllerAdvice，则必须在方法上添加 @ResponseBody 才能返回 JSON，否则 Spring 会尝试将其解析为视图名称。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
如何处理通用异常以提供默认兜底策略
除了处理特定业务异常，通常还需要一个通用的异常处理方法来捕获所有未被其他处理器捕获的异常（如 Exception 或 RuntimeException）。这作为系统的兜底策略，确保任何意外错误都能以友好的方式呈现，防止系统崩溃或泄露敏感内部细节。该方法应放在优先级较低的位置，或者通过 @Order 控制执行顺序。
package com.example.demo;
import org.springframework.web.bind.annotation.*;
import java.util.HashMap;
import java.util.Map;
@RestControllerAdvice
public class GlobalExceptionHandler {
// 通用兜底处理器
@ExceptionHandler(Exception.class)
public Map<String, Object> handleGenericException(Exception ex) {
Map<String, Object> body = new HashMap<>();
body.put("status", "system_error");
body.put("code", "5000");
// 生产环境建议记录日志而不是直接打印堆栈
body.put("message", "Internal Server Error: " + ex.getMessage());
return body;
}
@GetMapping("/crash")
public String crash() {
throw new NullPointerException("Something went wrong");
}
}
访问 /crash 接口，由于 NullPointerException 不是 BusinessException，它会被 handleGenericException 捕获。预期结果为 HTTP 200，响应体为：
{"status":"system_error","code":"5000","message":"Internal Server Error: null"}。这里的关键在于 Exception.class 作为父类，能够捕获所有运行时异常，但需注意不要让它先于更具体的异常处理器执行，否则具体异常将无法被针对性处理。
当多个异常处理器存在时，Spring 如何选择执行哪一个
当系统中存在多个 @ExceptionHandler 方法时，Spring 会根据异常类型的匹配度来选择执行哪个处理器。优先匹配最具体的异常类型，即子类异常优先于父类异常。如果定义了多个相同级别的处理器，可以通过 @Order 注解或实现 Ordered 接口来控制执行顺序，数值越小优先级越高。此外，@ControllerAdvice 可以限定作用范围（如仅针对特定包或特定 Controller），进一步缩小匹配范围。
