拦截器不推荐用于统一处理业务异常，因其无法捕获controller层抛出的异常；应使用@controlleradvice+@exceptionhandler统一封装，配合result响应体和bizexception实现标准化异常处理。
在 Spring Boot 项目中，拦截器（HandlerInterceptor）本身**不推荐**用于统一处理业务异常，因为它运行在 MVC 调度流程的早期（preHandle / postHandle），**无法捕获 Controller 层抛出的异常**（异常发生在 handler 执行时，而拦截器早已退出）。真正适合统一封装业务异常的地方是 @ControllerAdvice + @ExceptionHandler 或全局异常处理器。
为什么拦截器不适合做异常封装？
拦截器作用于请求进入 Controller 前（preHandle）、渲染视图后（postHandle）、整个请求完成后（afterCompletion）。它不参与 Spring MVC 的异常处理链路——当 Controller 抛出异常时，Spring 会跳过 postHandle，直接交给 DispatcherServlet 的异常处理机制，此时拦截器的 afterCompletion 方法虽会执行，但拿不到异常对象（除非你手动在 request attribute 中传递，极不优雅且易出错）。
正确做法：用 @ControllerAdvice 统一捕获并封装
这是 Spring 官方推荐、最简洁可靠的方式。只需定义一个全局异常处理器，集中处理所有 Controller 抛出的业务异常（如自定义的 BizException），并返回标准响应体（如 Result<t></t>）：
- 定义标准返回体：
public class Result{ private int code; private String msg; private T data; // getter/setter } - 定义业务异常类：
public class BizException extends RuntimeException { private int code = 400; public BizException(String msg) { super(msg); } public BizException(int code, String msg) { super(msg); this.code = code; } } - 编写全局异常处理器：
@ControllerAdvice
public class GlobalExceptionHandler {
@ExceptionHandler(BizException.class)
@ResponseBody
public ResulthandleBizException(BizException e) {
return Result.fail(e.getCode(), e.getMessage());
}
}
如果非要“在拦截器中感知异常”，可配合 RequestAttributes 做有限补充
仅适用于极特殊场景（例如需在 afterCompletion 中记录异常日志、清理资源），且必须搭配 Controller 主动存入异常信息。不推荐用于构造响应体，因为响应已提交或即将提交，再写 body 可能失败或被忽略：
- Controller 中捕获异常后存入 request：
try { ... } catch (BizException e) { request.setAttribute("EXCEPTION", e); throw e; } - 拦截器 afterCompletion 中读取：
Object ex = request.getAttribute("EXCEPTION");
if (ex instanceof BizException) {
// 记录日志、打点等，不要尝试修改 response body
}
进阶：结合 AOP 在 Service 层统一抛出业务异常
让业务逻辑更干净，避免 Controller 处处 try-catch。例如用 @Around 切 Service 方法，捕获特定异常（如校验失败、权限不足），自动转为 BizException 向上抛出，再由 @ControllerAdvice 统一封装：
- 定义切点：
@Pointcut("@annotation(org.springframework.web.bind.annotation.RequestMapping) || @annotation(org.springframework.web.bind.annotation.GetMapping)") - 环绕增强：
if (throwable instanceof ConstraintViolationException) {
throw new BizException(400, "参数校验失败：" + extractMessage(throwable));
}
不复杂但容易忽略：拦截器不是异常处理的主战场，把异常捕获和响应封装交给 Spring 的异常处理机制，才是清晰、可维护、符合约定的做法。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
