当前位置：首页 > news >正文

学习日报｜Spring 全局异常与自定义异常拦截器执行顺序问题及解决

news 2025/9/18 18:33:09

在 Spring Web 应用中，异常拦截机制是保障系统稳定性与用户体验的重要一环。然而，在同时存在全局异常拦截器与自定义异常拦截器时，常常会出现执行顺序与预期不符的情况。本文将从原理入手，分析问题并给出可行的解决方案。

一、问题背景

Spring 默认会对 @ControllerAdvice 标注的异常拦截器进行排序。排序逻辑是基于 类名的 ASCII 码顺序。

例如：

全局异常拦截器类名以 A 开头
自定义异常拦截器类名以 B 开头

由于 A 的 ASCII 码小于 B，Spring 会优先加载并使用 A 开头的全局异常拦截器。

👉 这就导致实际业务中出现“全国法先于地方法”的不合理情况。

二、期望逻辑

在实际业务开发中，通常更希望：

带有包范围限制的拦截器（@ControllerAdvice(basePackages=...)）优先执行
全局异常拦截器作为兜底

就像现实生活中的法律规则：

地方法：针对特定范围更精准，应该优先执行。
全国法：兜底处理，避免遗漏。

三、Spring 默认排序逻辑

Spring 内部在 ExceptionHandlerExceptionResolver 中，会扫描 @ControllerAdvice 并构建 ControllerAdviceBean 列表。
默认情况下，这个列表会根据类名 ASCII 排序，而不考虑是否指定了包范围。

代码简化示意：

List<ControllerAdviceBean> adviceBeans =ControllerAdviceBean.findAnnotatedBeans(getApplicationContext());adviceBeans.sort((bean1, bean2) -> bean1.toString().compareTo(bean2.toString()));

这种排序方式没有考虑“地方法优先”的需求。

四、解决思路

1. 改造排序逻辑

在初始化 ControllerAdviceBean 缓存时，识别出是否存在 选择器（selectors），即是否指定了 basePackages 或 assignableTypes 等限制条件。

带有选择器的 Advice → 判定为 自定义拦截器（地方法），应当优先。

示例代码：

adviceBeans.sort((ControllerAdviceBean bean1, ControllerAdviceBean bean2) -> {boolean hasSelectors1 = hasSelectors(bean1);boolean hasSelectors2 = hasSelectors(bean2);if (hasSelectors1 && !hasSelectors2) {// bean1 有范围限制 → 优先return -1;} else if (!hasSelectors1 && hasSelectors2) {// bean2 有范围限制 → 优先return 1;} else {// 两者都有或都没有 → 保持原有顺序return 0;}
});