Java 后端 / 系统课时

排查自调用导致的事务失效

排查自调用导致的事务失效

本课解决一个常见陷阱:方法上写了 @Transactional,但同一 Bean 内部调用后,注解定义的事务边界没有生效。关键不是注解有没有写,而是这次调用是否经过 Spring 事务代理,以及调用前是否已经存在事务。

学习目标

  • 能判断事务方法调用是否经过 Spring 代理。
  • 能复现并识别同一 Bean 自调用绕过事务拦截的问题。
  • 能选择拆分 Bean 等更清晰的修复方式,并理解已有事务下的边界。

先看调用路径

Spring 声明式事务在默认代理模式下通过 AOP 代理拦截方法调用。另一个 Bean 调用事务方法时,请求先进入代理,代理再根据传播行为开启、加入、提交或回滚事务;同一对象内部的 this.xxx() 则直接调用目标对象方法,不会再次经过代理。

Spring 事务代理与自调用路径

因此排查“事务失效”时,先确认三件事:谁发起调用、实际持有的对象是不是 Spring Bean、目标方法这一跳是否穿过代理。不要仅凭方法上存在 @Transactional 就判断事务一定按该注解执行。

用一个主示例验证

下面是片段示例,依赖一个已经启用事务管理并配置事务管理器的 Spring 应用。为了让结果可复现,应由另一个当前没有事务的 Spring Bean 分别调用两个 createOrder();示例同时展示自调用问题和拆分 Bean 后的修复。

java
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.transaction.support.TransactionSynchronizationManager;

@Service
class BrokenOrderService {

    public void createOrder() {
        // 自调用直接进入当前对象,saveOrder() 的事务拦截不会执行
        this.saveOrder();
    }

    @Transactional
    public void saveOrder() {
        System.out.println("broken="
                + TransactionSynchronizationManager.isActualTransactionActive());
    }
}

@Service
class OrderWriteService {

    @Transactional
    public void saveOrder() {
        // Bean 间调用会先进入 OrderWriteService 的事务代理
        System.out.println("fixed="
                + TransactionSynchronizationManager.isActualTransactionActive());
    }
}

@Service
class OrderService {

    private final OrderWriteService orderWriteService;

    OrderService(OrderWriteService orderWriteService) {
        this.orderWriteService = orderWriteService;
    }

    public void createOrder() {
        orderWriteService.saveOrder();
    }
}

预期结果

text
broken=false
fixed=true

第一行说明 BrokenOrderService.saveOrder() 虽然标了 @Transactional,但这次自调用没有触发事务拦截;第二行说明拆分到另一个 Bean 后,OrderService 调用 OrderWriteService 时经过代理,事务成功开启。

注意已有事务这个边界

“自调用导致事务失效”更准确的含义是:被自调用方法上的事务注解不会被这次调用重新解析和应用。如果外层方法本来就在事务中,内部方法仍会运行在那个已有事务里;只是它自己的传播级别、隔离级别、只读属性或 REQUIRES_NEW 等语义不会因为自调用而重新生效。

因此问题有时表现为“看起来有事务,但没有新事务”或“传播行为不符合预期”,而不一定总是完全没有事务。排查时必须把“当前是否有事务”和“目标方法上的注解是否被代理拦截”区分开。

优先把事务边界放到 Bean 之间

最稳妥的修复通常是像示例中那样拆分职责:编排逻辑留在 OrderService,真正需要事务边界的写入放到 OrderWriteService。这样调用天然经过 Spring 代理,事务语义清晰,也更容易测试和维护。

注入自身代理、AopContext.currentProxy() 等方式可以在受限场景下绕回代理,但会增加对 AOP 上下文和代理配置的耦合。排查时应先画清调用链,再决定是否真的需要独立事务边界;能用明确的 Bean 间调用表达事务语义时,通常不要用类内部绕代理的技巧。

按自己的节奏,确认真正理解。

目录与阅读设置

记录一个想法

排查自调用导致的事务失效

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通