springmvc 全局异常处理器配置的三种方式&深入底层源码分析原理

配置全局异常处理器的三种方式

实现接口HandlerExceptionResolver并配置到WebMvcConfigurer

定义一个类实现这个接口

/*** Interface to be implemented by objects that can resolve exceptions thrown during* handler mapping or execution, in the typical case to error views. Implementors are* typically registered as beans in the application context.** <p>Error views are analogous to JSP error pages but can be used with any kind of* exception including any checked exception, with potentially fine-grained mappings for* specific handlers.** @author Juergen Hoeller* @since 22.11.2003*/
public interface HandlerExceptionResolver {/*** Try to resolve the given exception that got thrown during handler execution,* returning a {@link ModelAndView} that represents a specific error page if appropriate.* <p>The returned {@code ModelAndView} may be {@linkplain ModelAndView#isEmpty() empty}* to indicate that the exception has been resolved successfully but that no view* should be rendered, for instance by setting a status code.* @param request current HTTP request* @param response current HTTP response* @param handler the executed handler, or {@code null} if none chosen at the* time of the exception (for example, if multipart resolution failed)* @param ex the exception that got thrown during handler execution* @return a corresponding {@code ModelAndView} to forward to,* or {@code null} for default processing in the resolution chain*/@NullableModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, @Nullable Object handler, Exception ex);}

定义一个配置类实现接口 WebMvcConfigurer 并重写方法configureHandlerExceptionResolvers将你定义的这个resolver加入到resolvers这个List即可

注解式配置@ExceptionHandler

要让spring扫描到这个类，一种方式是直接把这个类放到springboot能扫描的目录下（启动类当前目录或者子目录，或者在启动类手动配置的扫描组件目录），另一种方式是放在工具类里，定义到spring.factories里让spring扫描到，注意设置个@Order(0)让这个优先于springmvc注解错误处理器之前注入到容器，否则会无效，因为那个处理器只加载一次，后续不会再扫容器里的实例了。

/*** @author humorchen* date: 2024/6/11* description: 认证全局异常配置**/@Slf4j
@RestControllerAdvice
@Order(0)
public class AuthExceptionResolver {public static final int TOKEN_ERROR_CODE = HttpStatus.HTTP_UNAUTHORIZED;public static final String ERROR_MSG = "未登录或登录已失效!";/*** TOKEN相关异常** @param e* @return*/@ExceptionHandler({SaTokenException.class, JWTVerificationException.class})public Result<String> resolveAuthTokenException(Exception e) {log.info("handleSaTokenException {}: {}", e.getClass().getName(), e.getMessage());return Result.fail(TOKEN_ERROR_CODE, ERROR_MSG);}}

看到上面代码，你会有一个疑问，要是定义了多个，它怎么确定该用哪个呢，源码中使用ExceptionDepthComparator排序，排序规则是按照继承顺序来(继承关系越靠近数值越小，当前类最小为0,顶级父类Throwable为int最大值)，排序之后选取继承关系最靠近的那个，并且ExceptionHandlerMethodResolver的exceptionLookupCache中，key为当前抛出的异常，value为解析出来的匹配method.
org.springframework.core.ExceptionDepthComparator

controller里方法上定义@ExceptionHandler

@RestController
public class ExceptionController {@ExceptionHandler(Exception.class)public ResponseEntity<String> handleException(Exception ex) {return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("An error occurred: " + ex.getMessage());}@RequestMapping("/test")public String test() throws Exception {throw new Exception("Test exception!");}
}

深入源码分析

进入DispatcherServlet

执行handler方法并catch异常

调用processDispatchResult处理分发处理结果

发现有异常则调用processHandlerException 处理handler异常

如果有handlerExceptionResovlers就循环调用，直到有一个resolver返回了非空值就跳出循环

默认resolver，就是把这个异常放到了request.attribute里头去了

HandlerExceptionResolverComposite,是handler异常处理器的复合类，把这些resolver放到它内部一个集合


点开这个类源码看下，其实就是在我们在webmvcconfigurer里配置这个方法的时候，把配置的所有resolver设置进这个类里的this.resolvers 集合去了，进调试可以看到有两个resolver，一个是我自定义并配置上的ExceptionResolver，另一个是个Http请求异常处理器（seata的HttpHandlerExceptionResolver）

分布式事务用来清理ID的，不用管

第三个也是我注入的那个错误处理器
如果经过这些处理器，有一个返回了非空的结果，这个异常 处理就会被结束

执行完所有的resolver，有一个返回了ModelAndView的话就返回这个ModelAndView，否则继续抛出异常往上层传递。然后触发请求handler的triggerAfterCompletion，也就是执行你所有跟这个handler绑定的HandlerInterceptor的afterCompletion

前面看的都是HandlerExceptionResolver的实现，还有那个注解式的实现，我们也一起看下这个ExceptionHandlerExceptionResolver 类的源码，就是用来处理 @ExceptionHandler的

/*** An {@link AbstractHandlerMethodExceptionResolver} that resolves exceptions* through {@code @ExceptionHandler} methods.** <p>Support for custom argument and return value types can be added via* {@link #setCustomArgumentResolvers} and {@link #setCustomReturnValueHandlers}.* Or alternatively to re-configure all argument and return value types use* {@link #setArgumentResolvers} and {@link #setReturnValueHandlers(List)}.** @author Rossen Stoyanchev* @author Juergen Hoeller* @since 3.1*/
public class ExceptionHandlerExceptionResolver extends AbstractHandlerMethodExceptionResolverimplements ApplicationContextAware, InitializingBean {@Nullableprivate List<HandlerMethodArgumentResolver> customArgumentResolvers;@Nullableprivate HandlerMethodArgumentResolverComposite argumentResolvers;@Nullableprivate List<HandlerMethodReturnValueHandler> customReturnValueHandlers;@Nullableprivate HandlerMethodReturnValueHandlerComposite returnValueHandlers;private List<HttpMessageConverter<?>> messageConverters;private ContentNegotiationManager contentNegotiationManager = new ContentNegotiationManager();private final List<Object> responseBodyAdvice = new ArrayList<>();@Nullableprivate ApplicationContext applicationContext;private final Map<Class<?>, ExceptionHandlerMethodResolver> exceptionHandlerCache =new ConcurrentHashMap<>(64);private final Map<ControllerAdviceBean, ExceptionHandlerMethodResolver> exceptionHandlerAdviceCache =new LinkedHashMap<>();

在这个bean执行到afterPropertiesSet这个时间点的时候进行了 @ExceptionHandler实现的扫描initExceptionHandlerAdviceCache()，如果你的 @ExceptionHandler配置bean在这个时间点之后注入进IOC容器的话，那么恭喜你，你的配置不会生效，因此前面我说要让自己的这个配置优先级变高，才能生效。

ControllerAdviceBean.findAnnotatedBeans(getApplicationContext())
把所有的标注了@ControllerAdvice注解的bean全部找出来并根据order排序返回了

看到这你会疑问还有个@RestControllerAdvice，来看源码,@RestControllerAdvice上标注了@ControllerAdvice

前面已经看了加载过程，现在看执行处理异常的代码，其实就是拿着加载好的处理器，去调用处理，然后参数呢又是可选的，随便你定义，那个其实是反射拿到你方法定义的参数，然后跟现有能给你的一些参数比对类型，然后组成一个参数数组，传入执行对象、参数反射执行方法，然后就拿到了异常处理结果

组装生成调用参数数组的方法就在这org.springframework.web.method.support.InvocableHandlerMethod#getMethodArgumentValues

也就是把异常对象和当前的handlerMethod给你了，你自己可以写到参数里它会注入给你的

ExceptionHandler原理另一个作者也写的不错：
从源码角度去深入分析关于Spring的异常处理ExceptionHandler的实现原理