Java 后端 / 系统课时
排查事务边界与代理对象问题
排查事务边界与代理对象问题
本课解决另一类常见事务失效:方法明明写了 @Transactional,运行后却没有进入事务。重点不是继续修改注解参数,而是确认 Spring 是否创建了代理、调用是否经过代理,以及目标方法是否满足当前代理机制的拦截条件。
学习目标
- 能判断 Bean 是否被 Spring 事务代理增强。
- 能识别自调用、错误 Bean 获取方式和方法可见性导致的典型失效。
- 能用代理信息与调用路径快速缩小排查范围。
先确认调用对象是不是代理
@Transactional 通常依赖 Spring AOP 代理拦截方法调用。真正进入事务逻辑的前提,是调用先经过这个代理,再由代理调用目标对象。因此源码里“存在注解”并不能证明运行时调用一定经过事务拦截器。
排查第一步应直接观察 Bean 的运行时类型和代理状态。下面是一个片段示例,依赖已有 Spring Boot 事务项目,可放在测试代码或启动检查逻辑中。
import org.springframework.aop.support.AopUtils;
import org.springframework.context.ApplicationContext;
import org.springframework.stereotype.Component;
@Component
public class TransactionProxyProbe {
public void inspect(ApplicationContext context, String beanName) {
Object bean = context.getBean(beanName);
System.out.println("bean class=" + bean.getClass().getName());
System.out.println("is aop proxy=" + AopUtils.isAopProxy(bean));
System.out.println("target class=" + AopUtils.getTargetClass(bean).getName());
}
}预期结果:当目标 Bean 已被 Spring AOP 增强时,is aop proxy 应为 true;没有创建代理时则为 false。代理类名称可能包含 CGLIB 或 JDK 动态代理相关信息,实际名称不要写死在断言中。
bean class=...Proxy...
is aop proxy=true
target class=com.example.OrderService优先排查自调用
最典型的问题是同一个对象内部通过 this.someTransactionalMethod() 调用事务方法。这个调用直接落到目标对象本身,没有经过 Spring 代理,因此事务拦截器没有机会介入。
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
@Service
public class OrderService {
public void createOrder() {
// 自调用绕过代理,下面的事务拦截不会按预期触发。
this.saveOrder();
}
@Transactional
public void saveOrder() {
// 依赖事务上下文的数据库操作
}
}预期结果:调用 createOrder() 时,saveOrder() 的执行不会因为方法上存在 @Transactional 就自动创建事务。正确排查方式是把事务方法拆到另一个 Spring Bean,再由外部 Bean 调用它,确保调用路径经过代理。
检查 Bean 获取方式和代理类型
另一个常见原因是绕过 Spring 容器自己创建对象,例如直接使用 new OrderService(...)。这个实例没有经过容器创建和后处理,也不会自动获得事务代理。
代理类型也会影响排查方式。Spring 可以使用 JDK 动态代理或基于类的代理,因此注入接口时,JDK 代理通常更自然;使用类类型注入时,需要确认当前配置实际采用的代理策略是否与调用方式兼容。不要根据某一种代理类名称去判断所有项目。
检查方法可见性与特殊方法
事务拦截依赖 AOP 代理能够识别并拦截目标方法。排查时优先使用公开的业务入口方法,并特别检查方法是否为 private、是否发生自调用,以及是否存在 final 等限制代理的设计。具体可拦截范围还取决于使用的代理机制和 Spring 配置,因此不要把某条经验直接扩大成所有版本、所有代理方式的绝对规则。
推荐把事务边界放在清晰的业务服务入口:由容器管理的 Bean 暴露公开业务方法,调用者从另一个 Bean 进入该方法,事务注解落在真正的业务边界上。这样的结构比依赖类内部调用更容易验证,也更不容易在重构后悄然失效。
用一条调用链完成定位
发现事务似乎没有生效时,可以固定按这个顺序排查:先确认实例来自 ApplicationContext,再确认运行时对象是否是 AOP 代理,然后检查调用是否从代理入口进入,最后检查目标方法的可见性和代理限制。只有这些条件都成立后,才继续分析事务传播、隔离级别或回滚规则。
当 ApplicationContext 取得的 Bean 明确是代理,但内部某次调用仍没有事务效果,最值得怀疑的就是自调用或实际执行的并非你认为的那个方法。把“源码注解”转换成“运行时代理与调用路径”来观察,通常能比单纯阅读 @Transactional 更快定位事务失效原因。