错误场景

验证请求的Token合法性的Filter。Token校验失败时，直接抛自定义异常，移交给Spring处理：



测试HTTP请求：

日志输出如下：说明IllegalRequestExceptionHandler未生效。

why？
这就需要精通Spring异常处理流程了。

解析

当所有Filter被执行完毕，Spring才会处理Servlet相关，而DispatcherServlet才是整个Servlet处理核心，它是前端控制器设计模式，提供 Spring Web MVC 的集中访问点并负责职责的分派。

在这，Spring处理了请求和处理器的对应关系及统一异常处理。

Filter内异常无法被统一处理，就是因为异常处理发生在 DispatcherServlet#doDispatch()

但此时，过滤器已全部执行完。

Spring异常统一处理

ControllerAdvice如何被Spring加载并对外暴露？

WebMvcConfigurationSupport#handlerExceptionResolver()

实例化并注册一个ExceptionHandlerExceptionResolver 的实例

最终按下图调用栈，Spring 实例化了ExceptionHandlerExceptionResolver类。

ExceptionHandlerExceptionResolver实现了InitializingBean

重写 afterPropertiesSet()

initExceptionHandlerAdviceCache

完成所有 ControllerAdvice 中的ExceptionHandler 初始化：查找所有 @ControllerAdvice 注解的 Bean，把它们放入exceptionHandlerAdviceCache。
这里即指自定义的IllegalRequestExceptionHandler


所有被 @ControllerAdvice 注解的异常处理器，都会在 ExceptionHandlerExceptionResolver 实例化时自动扫描并装载在其exceptionHandlerAdviceCache。

initHandlerExceptionResolvers

当第一次请求发生时，DispatcherServlet#initHandlerExceptionResolvers() 将获取所有注册到 Spring 的 HandlerExceptionResolver 实例（ExceptionHandlerExceptionResolver正是），存到handlerExceptionResolvers

ControllerAdvice如何被Spring消费并处理异常？

DispatcherServlet

doDispatch()

执行用户请求时，当查找、执行请求对应的 handler 过程中异常时：

1. 会把异常值赋给 dispatchException
2. 再移交 processDispatchResult()

processDispatchResult

当Exception非空时，继续移交

processHandlerException

从 handlerExceptionResolvers 获取有效的异常解析器以解析异常。

这里的 handlerExceptionResolvers 一定包含声明的IllegalRequestExceptionHandler#IllegalRequestException 的异常处理器的 ExceptionHandlerExceptionResolver 包装类。

修正

为利用到 Spring MVC 的异常处理机制，改造Filter：

• 手动捕获异常
• 将异常通过 HandlerExceptionResolver 进行解析处理

据此，修改 PermissionFilter，注入 HandlerExceptionResolver：

然后，在 doFilter 捕获异常并移交 HandlerExceptionResolver：

现在再用错误 Token 请求，日志输出如下：
响应体：