外观
10 - 同类调用为什么绕过 AOP:事务、异步与缓存失效的共同根因
适用版本:Spring Framework 6.x、Spring Boot 3.x。
前置阅读:09 - Spring AOP 如何创建代理。本文讨论运行期调用边界;它与 07 - 三级缓存与循环依赖处理的创建期依赖环不是同一个问题。
摘要
@Transactional、@Async、@Cacheable 标在方法上,并不意味着每次调用都会执行对应功能。在 Spring 默认的代理模式下,同一个对象内部直接调用自己的方法,称为自调用。它不会重新进入代理,因此不会触发被调用方法对应的增强逻辑。理解这个调用边界,就能排查三类注解的共同失效原因。
1. 场景:事务方法被调用了,为什么没有事务
Spring AOP(面向切面编程)通过代理把事务等公共逻辑放在业务调用的外围。代理对象接收调用,执行匹配的增强逻辑,再把调用交给目标对象;目标对象执行实际业务。拦截器就是调用链中负责执行增强逻辑的组件。注解提供配置,真正执行功能的是拦截器。
下面是服务类片段,省略导入和项目配置。对比事务行为时,需要在 Spring 应用中注册该服务、启用声明式事务,并配置适用的事务管理器;外部调用方取得的是服务代理。
java
@Service
class OrderService {
public void create() {
saveInTransaction();
}
@Transactional
public void saveInTransaction() {
// 写数据库
}
}外部通过代理调用 create() 后,业务代码在目标对象上执行。此时 this 指向目标对象,省略接收者的 saveInTransaction() 相当于 this.saveInTransaction()。它直接调用目标对象的方法,不会先绕回代理,所以 saveInTransaction() 的事务拦截器没有机会执行。
预期行为:若进入 create() 前没有已有事务,且业务代码没有通过其他方式开启事务,这次自调用不会因内部方法上的注解而开启事务。若外层已经存在事务,内部方法仍可能在该事务中执行;失效的是内部注解声明的事务边界,不能据此断定当前完全没有事务。
图表将在阅读到此处时加载…
2. 共同根因
在本文讨论的代理模式下,事务、异步、缓存等声明式能力都依赖 AOP 拦截器。要触发对应拦截器,需要同时满足以下条件:
- 对象由 Spring 管理并被代理;
- 调用从代理外部进入;
- 方法满足切点(选择哪些方法进行增强的规则)和代理能力限制;
- 对应基础设施已启用。
自调用破坏的是第二点:方法执行了,负责增强它的入口却被绕过了。
判断时要观察实际调用边,而不是只看两个方法是否写在同一个类中:
text
外部对象 → Spring 代理 → 增强方法 可以触发拦截
目标对象 this → 本类方法 不会重新进入代理
目标对象 → 另一个 Spring Bean 的代理 可以触发对方拦截即使外层方法本身已经经过代理,进入目标对象后发生的 this 调用也不会自动回到代理。
3. 推荐修复:拆分职责
把流程编排和事务操作拆成两个 Spring Bean(由容器管理的对象)。编排服务通过注入的协作对象调用事务方法,让调用穿过事务服务的代理。以下仍是服务类片段,事务配置前提与第 1 节相同。
java
@Service
class OrderApplicationService {
private final OrderTransactionService transactionService;
OrderApplicationService(OrderTransactionService transactionService) {
this.transactionService = transactionService;
}
public void create() {
transactionService.saveInTransaction();
}
}
@Service
class OrderTransactionService {
@Transactional
public void saveInTransaction() {
// 写数据库
}
}这里的关键是 transactionService 引用指向 Spring 提供的代理。create() 负责组织流程,saveInTransaction() 负责需要事务保护的操作,事务边界随职责拆分而清晰。如果自行 new OrderTransactionService() 并直接调用,就没有建立这条代理调用路径。
4. 其他方案及代价
注入自身代理
可以通过延迟注入自身接口代理,再用该引用调用增强方法。延迟注入把依赖的解析推迟到使用时;真正起作用的是调用经过代理,而不是“延迟”本身。
这种方案让服务依赖自身,使调用关系更难理解和测试,也可能重新引入创建期的循环依赖。若必须使用,应封装这条调用路径,确认取得的是代理而不是目标对象,并通过集成测试验证。
AopContext.currentProxy()
AopContext.currentProxy() 用于取得当前 AOP 调用所关联的代理。使用它需要启用代理暴露,并且当前调用已经进入支持该上下文的代理;它不是随时都能从容器取得自身 Bean 的工具。
这会让业务代码显式依赖 Spring AOP 上下文。该上下文与当前线程相关,切换线程后不能直接沿用这条获取路径,因此一般不作为首选。
AspectJ 编织
编织是把增强逻辑织入字节码的方式,不依赖每次调用都经过外部代理。AspectJ 可通过相应的编织配置增强对象内部调用,但代理模式下的现有注解配置不会因此自动获得该能力。它的构建、运行和调试模型不同于默认 Spring AOP;除非项目已经采用,不应只为一个自调用问题贸然引入。
5. @Async 的额外风险
@Async 通过异步拦截器把任务交给执行器(Executor),由执行器安排执行。下面是方法片段,使用前需要启用异步方法支持并注册相应服务。
java
@Async
public void sendMessage() { }自调用绕过异步拦截器,任务不会因这个注解而提交给执行器,而是在当前线程直接执行。如果它位于请求处理路径上,耗时工作就可能增加请求延迟。即使外部代理调用生效,也要显式配置线程池、队列容量、拒绝策略和异常处理;默认行为需按 Boot 版本核对。
void 异步方法的异常不会通过返回值交给调用方,需要配置异常处理器或在任务内部记录;返回 Future/CompletableFuture 时,则应由调用方观察异常和取消。不要只用“线程名变化”验证异步,还应验证拒绝、异常和关闭路径。
6. @Cacheable 的额外风险
@Cacheable 的缓存拦截器按缓存键(Key)查找结果,命中时可以直接返回缓存值,避免执行目标方法。自调用绕过这一层,不会由该注解完成缓存查询或结果写入,目标方法仍会执行。若方法访问数据库,重复调用就可能增加数据库负载;排查时应同时观察代理类型、缓存指标和实际 SQL。
经过代理也不保证缓存命中或写入:缓存键决定查询哪个条目,condition 控制是否应用缓存,unless 可以否决结果写入。因此“SQL 执行了两次”既可能是自调用,也可能是键不一致、条件不满足、缓存驱逐或缓存实现故障,需要分别取证。
7. 三类能力的最小验证
推荐使用 Spring 测试上下文取得容器提供的 Bean,而不是直接 new。以下是测试骨架,需补齐 JUnit、AssertJ 和 Spring 的导入及测试依赖,并提供应用配置、事务管理器和对应服务。它只断言对象是 AOP 代理,尚未包含事务行为断言:
java
@SpringBootTest
class ProxyBoundaryTest {
@Autowired OrderService orderService;
@Test
void externalCallCrossesProxy() {
assertThat(AopUtils.isAopProxy(orderService)).isTrue();
orderService.saveInTransaction();
// 再结合事务日志、数据库结果或测试切面计数器断言拦截器已进入。
}
}对三类注解应使用不同证据:
| 能力 | 不充分证据 | 更可靠证据 |
|---|---|---|
@Transactional | 方法上有注解 | 实际事务处于 active,且提交/回滚结果符合预期 |
@Async | 方法返回很快 | 执行线程、Executor、异常与拒绝路径均符合预期 |
@Cacheable | 第二次似乎更快 | 目标方法计数、缓存 Key 和命中指标符合预期 |
对第 1 节的服务,分别通过容器取得的 Bean 调用 saveInTransaction() 和 create(),并在目标方法内部采集证据。预期前者进入事务拦截器,后者的内部自调用不进入。对比时不要让测试方法自身的事务掩盖差异;还应排除已有缓存、并发调用等干扰,用断言检查结果。
命令式事务可结合 TransactionSynchronizationManager.isActualTransactionActive() 观察当前线程的实际事务状态,再验证提交和回滚结果。仅有事务同步处于 active 不足以证明存在实际事务。异步验证要等待任务完成,缓存验证要在相同键和明确的初始缓存状态下比较目标方法执行次数。
8. 容易踩的坑
- 单元测试直接
new对象,却期望事务或缓存生效。 private方法标注增强注解,代理无法按普通外部调用方式拦截。- 在
@PostConstruct中调用增强方法,此时最终代理调用路径尚未建立。 - 异步方法返回值类型与异常处理方式不匹配,错误悄悄丢失。
- 为解决自调用而制造循环依赖。
- 看到 Bean 是代理,就直接断定当前方法一定被拦截。
- 强制改成 CGLIB,误以为子类代理会让
this调用重新经过代理。
9. 快速验证
以下是诊断片段,context 表示已注册该服务的 Spring 应用上下文,需导入 org.springframework.aop.support.AopUtils。这里按 OrderService 类获取 Bean;若服务采用 JDK 接口代理,应改为按代理暴露的业务接口获取。
java
Object bean = context.getBean(OrderService.class);
System.out.println(bean.getClass());
System.out.println(AopUtils.isAopProxy(bean));预期输出取决于配置:已由 Spring AOP 包装的对象,第二行是 true;普通对象是 false。第一行的具体类名随代理策略和环境变化,不应作为固定断言。
这个检查只回答“对象是不是代理”。随后还要在拦截器入口或事务日志上确认具体调用是否经过对应的增强链。
方法可见性不能用一句“只有 public 才能代理”概括:JDK 接口代理通过接口接收调用,CGLIB 类代理通过子类覆盖方法接收调用;Advisor(关联增强逻辑与适用范围的组件)还可能增加自己的限制。事务、异步等不同 Advisor 的支持范围可能不同。稳定判断方式是检查代理策略、方法是否由代理暴露、对应 Advisor 是否匹配,并在目标 Spring 版本运行集成测试。
10. 总结
声明式能力生效的前提是调用穿过代理边界;this 调用只发生在目标对象内部。
- 事务、异步和缓存的自调用失效具有相同代理根因。
- 拆分协作对象通常比获取自身代理更清晰、更易测试。
- 排查时同时确认对象来源、代理类型、方法可见性与真实调用路径。
阅读导航
- 代理如何创建:09 - Spring AOP 如何创建代理
- 事务拦截器如何工作:11 - Spring 声明式事务执行链
- 事务失效专项排查:13 - Spring 事务为什么没有回滚
- 创建期自依赖与早期引用:07 - 三级缓存与循环依赖
- 异步线程池容量:并发 09 - ThreadPoolExecutor 参数与容量设计
- 异步代理与上下文边界:27 - Spring
@Async - 方法缓存的代理与 Key:28 - Spring Cache
- 缓存击穿与重复加载:分布式 18 - 缓存穿透、击穿与雪崩