外观
24 - Spring 切面顺序与组合语义:事务、重试与缓存谁包住谁
适用版本:Spring Framework 6.x、Spring Boot 3.x。具体 Advisor 的默认顺序应按所用框架版本和配置核对。
前置阅读:09 - Spring AOP 如何创建代理、10 - 同类调用为什么绕过 AOP和11 - Spring 声明式事务执行链。
摘要
同一个方法同时使用事务、重试、缓存和监控时,即使每项功能都执行了,组合后的行为仍可能不符合预期。例如,失败后重试究竟会开启新事务,还是继续使用原事务,取决于调用经过各个拦截器的顺序。本文先建立嵌套调用模型,再分析常见组合,最后说明如何检查实际调用链和失败路径。
1. 顺序改变业务语义
Spring AOP(面向切面编程)通过代理在业务方法前后执行附加逻辑。代理是调用方访问业务对象的入口;拦截器负责执行事务、重试等逻辑,并决定是否继续调用下一层。Advisor 把“匹配哪些方法”的规则与“执行什么增强逻辑”的 Advice 关联起来,代理据此为当前方法组织拦截器链。本文讨论调用确实经过代理的情况,同类内部调用等绕过代理的路径不适用。
先把调用链理解为一层套一层的函数调用。箭头表示进入下一层,左边包住右边;Target 是最终的业务方法。假设调用链是:
text
Retry → Transaction → Target重试拦截器在外层,可以在内层调用失败后再次调用它。这样,每次尝试都会重新进入事务拦截器,由它按事务传播规则决定创建还是加入事务。若没有外层已有事务,且每次尝试都创建并完成自己的事务,就能在前一次回滚结束后开启新事务。若使用 REQUIRED 加入调用方已有的事务,仅把重试放在外层仍不能保证每次得到新物理事务。事务传播规则见12 - Spring 事务传播行为。
如果顺序变成:
text
Transaction → Retry → Target事务拦截器先进入,再调用内层重试逻辑,因此多次尝试可能发生在同一个事务作用域中。重试若在内层捕获异常,外层事务拦截器也未必能看到每次失败。数据库错误或参与事务的其他调用仍可能使资源失效,或把事务标记为 rollback-only(只能回滚、不能提交);此时后续尝试即使返回成功,最终也未必能够提交。并非任意异常都会造成这种状态,需要结合数据库行为和事务回滚规则判断。
两种顺序的差别会影响事务次数、锁持有时间和失败恢复方式。缓存与监控也遵循同样的嵌套模型:它们包住哪一段调用,就在哪一段调用前后执行自己的逻辑。
2. Advisor 链如何执行
代理为当前方法取得匹配的拦截器链。MethodInvocation 表示一次方法调用,proceed() 表示继续进入下一层;链走到末端才执行目标方法。下面是两层拦截器在正常返回路径上的示意,before、after 分别表示调用下一层之前和之后的逻辑:
text
Interceptor A before
Interceptor B before
target
Interceptor B after
Interceptor A afterA 先进入、后退出,因此 A 在外层,B 在内层。异常也沿调用栈向外传播,但某一层可以捕获异常、重试或转换异常;上图的 after 不代表所有后置逻辑在异常路径上都会执行。
对于同一代理中按 Spring 标准排序规则排列的普通 Ordered Advisor,order 数值越小,优先级越高,在链中越靠前,也就越靠外层。原因是排序先按数值升序排列 Advisor,而 proceed() 从链首逐层进入:排在前面的拦截器先调用下一层,等下一层返回后才继续自己的逻辑。“优先级高”描述进入顺序,不表示它的后置逻辑也先执行。
例如,A 的 order=10、B 的 order=20,且二者都匹配当前方法,则形成上图的 A → B → Target;把数值交换后,就变成 B → A → Target。Ordered.HIGHEST_PRECEDENCE 是 Integer.MIN_VALUE,Ordered.LOWEST_PRECEDENCE 是 Integer.MAX_VALUE,因此“最低优先级”对应最大的数值。数值规则见 Spring Framework 6.2.0 的 Ordered 契约与 OrderComparator 实现,链首进入的机制见 ReflectiveMethodInvocation.proceed()。
这条规则不能脱离排序方式使用:PriorityOrdered 是优先排序的标记接口,标准比较器会先把它与普通 Ordered 分组,再比较组内数值;专用比较器、基础设施插入的 Advisor 或多层代理也可能影响最终位置。相同 order 不保证相互顺序。注解在源码中的上下位置同样不能说明谁包住谁,应检查最终调用链。
2.1 源码定位
排查时可沿下面几处进入源码:
text
AbstractAutoProxyCreator
→ wrapIfNecessary(...)
→ getAdvicesAndAdvisorsForBean(...)
→ createProxy(...)
AbstractAdvisorAutoProxyCreator
→ findEligibleAdvisors(...)
→ sortAdvisors(...)
JdkDynamicAopProxy / CglibAopProxy
→ advised.getInterceptorsAndDynamicInterceptionAdvice(...)
→ ReflectiveMethodInvocation.proceed()AbstractAdvisorAutoProxyCreator 默认使用与 Ordered、@Order 兼容的比较规则排序候选 Advisor;具体基础设施 Advisor 还可能通过自身 order 属性参与排序。源码类名和内部方法在小版本中可能调整,判断业务语义时应以代理上最终 Advisor 数组为证据。
2.2 直接查看运行时链
下面是诊断片段,需要已有 Spring 应用上下文 context 和业务类型 OrderService,并导入 Spring 的 AopUtils、Advised、Advisor、Ordered 以及 AssertJ 的 assertThat。片段使用 Java 的 instanceof 模式匹配语法。
java
Object bean = context.getBean(OrderService.class);
assertThat(AopUtils.isAopProxy(bean)).isTrue();
Advised advised = (Advised) bean;
for (Advisor advisor : advised.getAdvisors()) {
int order = advisor instanceof Ordered ordered
? ordered.getOrder()
: Ordered.LOWEST_PRECEDENCE;
System.out.println(advisor + " advisorOrder=" + order);
}这段代码用于诊断;部分 Advisor 的有效顺序可能来自内部 Advice 或专用比较规则,所以输出只能作为线索,不能替代调用序列测试,也不能把字符串格式当成稳定 API。若代理没有实现 Advised、被其他代理层包裹,或使用了不同 AOP 基础设施,应改用断点、Actuator 自定义诊断或测试 Advice 记录进入顺序。
3. 常见组合
3.1 重试与事务
通常希望一次失败尝试完整回滚,再开启新事务重试:
text
retry outside
→ transaction attempt 1 → rollback
→ transaction attempt 2 → commit这要求前一次尝试的事务确实已经完成,下一次不会继续加入同一个外层事务。回滚规则也必须覆盖要重试的失败,否则“抛出异常”不等于“已经回滚”。
操作还应具备幂等性,即重复执行同一业务操作不产生额外副作用。数据库回滚不能撤销已经发出的外部请求或通知,因此新事务并不能代替幂等设计。只应重试明确的瞬态错误,也就是有可能在后续尝试中消失的错误;参数错误等稳定失败不应靠重复调用解决。数据库死锁和序列化失败的处理见数据库 20 - 死锁定位与修复。
3.2 缓存与事务
缓存写入是把结果保存到缓存,缓存驱逐是删除已有缓存项。假设业务同时更新数据库和缓存:若缓存先写入、数据库随后提交失败,缓存中就可能出现数据库里不存在的结果;若数据库先提交、随后才驱逐缓存,进程在两步之间崩溃又可能留下旧值。
这里的“双写窗口”是两个资源更新之间可能发生故障的时间间隔。调整切面顺序可以改变先后关系,却不能使数据库与缓存自动成为一个原子操作。还要检查缓存组件是否把更新延后到事务完成阶段,不能仅凭外层、内层位置推断实际写入时机。
缓存与数据库一致性需要结合业务容忍度选择方案,例如延迟双删(更新前后删除缓存,第二次删除延迟执行)、消息或 CDC(变更数据捕获,从数据库变更中驱动后续处理)。这些方案也有各自的失败与恢复条件,见分布式 17 - 缓存与数据库一致性。
3.3 监控与重试
监控在重试外层时,计时区间通常覆盖整次调用,包括多次尝试以及重试逻辑中的等待;在重试内层时,每次尝试分别经过监控,因此可以记录单次尝试耗时。两种指标分别用于回答“调用方等了多久”和“每次执行花了多久”,应明确命名:
- operation latency:调用方观察到的总耗时;
- attempt latency:单次尝试耗时;
- retry count:额外尝试次数。
4. 顺序来源
常见顺序来源包括:
- Advisor 自身实现
Ordered; - 配置注解暴露 order 属性;
- 用户提供的切面使用
@Order; - 框架基础设施使用默认最低优先级;
- 程序化注册顺序。
配置时,先确定谁要在外层,再把这个 Advisor 的有效 order 设得更小。以下是两个普通 Ordered Advisor 在同一代理中按标准规则排序的配置示意,数值用于说明相对关系,不代表任何库的默认值:
| 期望的两层结构 | 重试 Advisor 的 order | 事务 Advisor 的 order | 进入与正常退出顺序 |
|---|---|---|---|
Retry → Transaction → Target | 10 | 20 | 重试先进入,事务先退出 |
Transaction → Retry → Target | 20 | 10 | 事务先进入,重试先退出 |
应通过所用重试库和事务基础设施支持的配置分别设置这两个 Advisor 的顺序。顺序值控制调用位置,是否创建新事务仍取决于第 1 节的传播条件。
@Order 也必须作用于相应排序机制能识别的切面或 Advisor,不能假定给业务类加一个 @Order 就能统一控制事务、缓存和重试。若用程序化方式直接组装代理,还要确认所用 API 是否排序,还是按添加位置构建链。
多个组件恰好使用相同 order 时,不应依赖偶然注册顺序作为业务契约。不同版本或新增 Starter(用于引入依赖和自动配置的启动依赖)都可能改变链的位置。
5. 最小验证
以下是测试设计与局部 Java 片段,需要补齐依赖、导入和测试装配。事务用例需配置真实的事务管理器与数据库,通过代理调用目标方法,并明确重试异常类型、最大尝试次数和事务传播规则。测试本身若已有外层事务,也会影响被测方法是否创建新事务。
为每个拦截器记录结构化事件,即使用约定的事件名称和尝试编号,便于断言先后关系。下面的片段依赖事件集合 events、尝试编号 attempt 和 Spring 的 TransactionSynchronizationManager:
java
events.add("retry.before:" + attempt);
events.add("tx.active:" + TransactionSynchronizationManager
.isActualTransactionActive());
events.add("target");测试应断言完整序列,而不是只断言所有 Advice 都执行过。以下为“第一次回滚、第二次新建事务并提交”的预期输出,事务开始与完成事件需要另行采集:
text
retry.before:1
tx.begin:1
target:1
tx.rollback:1
retry.before:2
tx.begin:2
target:2
tx.commit:2还应在被测事务完成后,用独立连接检查最终数据库状态,并结合事务开始、完成记录确认两次尝试是否对应两个物理事务。isActualTransactionActive() 只能说明当前存在实际事务,不能单凭两次返回 true 就证明它们是不同事务;最终数据正确也不能单独证明事务边界。
失败注入是人为制造一次可控异常,用来观察恢复路径。测试应同时保存尝试编号与事务完成结果。下面是目标方法片段,依赖 AtomicInteger、事件集合 events、Spring 事务与数据访问异常类型,以及执行写入的 repository;事务和重试配置需要在测试装配中提供:
java
AtomicInteger attempts = new AtomicInteger();
public void execute() {
int attempt = attempts.incrementAndGet();
events.add("target:" + attempt + ":" +
TransactionSynchronizationManager.isActualTransactionActive());
if (attempt == 1) throw new TransientDataAccessException("injected") {};
repository.insert("business-key");
}这段代码在第一次尝试中先抛异常,没有执行 repository.insert(),因此它主要检查重试次数与事务完成路径,不能用来证明“第一次已经写入的数据被回滚”。在预期的新事务重试配置下,应断言目标方法调用两次、最终只存在一个业务键,并通过事务同步回调记录一次回滚和一次提交。事务同步回调是事务完成阶段触发的通知,可用于记录最终结果。
若还要验证失败尝试中的写入确实回滚,需要另设“先写入、后失败”的用例,再从独立连接检查第一次写入不可见。只断言最终成功,无法区分新事务重试与同一事务内继续执行。
Framework 与扩展库边界
Spring Framework 提供 AOP、事务和缓存 Advisor;通用重试注解通常来自 Spring Retry 或其他库。它们的默认 order 不是 Spring Framework 可以统一保证的契约。升级 Framework、Boot、Retry、缓存 Starter 或观测 Agent 后,都应重新检查实际链。
6. 工程选型
- 先画出期望的嵌套结构;
- 明确每一层失败时能否重试、回滚或缓存;
- 为 Advisor 配置显式顺序;
- 用集成测试断言进入、退出和异常路径;
- 升级框架或新增 Starter 后重新检查代理上的 Advisor。
若组合已经难以解释,优先把可靠性流程写成显式编排,而不是继续叠加注解。
7. 容易踩的坑
- 认为所有注解生效就代表组合正确。
- 只测试成功路径,没有测试第一次失败后的事务状态。
- 重试非幂等写操作,制造重复数据。
- 依赖相同 order 下的偶然注册顺序。
- 监控只记录最终成功,隐藏前面多次失败尝试。
- 用缓存切面顺序替代跨资源一致性设计。
8. 总结
多个声明式能力叠加时,真正的配置是拦截器嵌套顺序,而不是注解集合。
- 重试与事务的内外关系决定是否重新进入事务拦截器;能否获得新事务,还取决于传播规则和外层事务。
- 缓存和数据库属于不同资源,调整切面顺序不能消除全部故障窗口。
- 顺序必须通过 Advisor 检查和异常路径集成测试证明。
阅读导航
- Advisor 创建:09 - Spring AOP 如何创建代理
- 自调用边界:10 - 同类调用为什么绕过 AOP
- 事务执行链:11 - Spring 声明式事务执行链
- 事务传播:12 - Spring 事务传播行为
- 异步执行边界:27 - Spring
@Async - 缓存操作边界:28 - Spring Cache
- 缓存一致性:分布式 17 - 缓存与数据库一致性