Java 后端 / 系统课时

排查跨线程与异步事务问题

排查跨线程与异步事务问题

本课解决一个常见误区:调用方已经进入 @Transactional,为什么 @Async 方法里的数据库操作仍没有加入同一个事务。你将用线程名和事务活动状态确认边界,并据此区分“事务传播问题”和“异步线程切换问题”。

学习目标

  • 能解释命令式 Spring 事务为什么默认不能跨线程直接共享。
  • 能显式启用异步注解支持,并用运行时证据确认 @Async 是否真的切换线程。
  • 能根据一致性要求选择同步原子事务、独立异步事务或可靠事件方案。

事务为什么跨不过线程

在基于 PlatformTransactionManager 的常规命令式事务中,Spring 会把事务资源和同步状态绑定到当前执行线程。同一线程继续调用下层方法时,可以参与已有事务;@Async 一旦把目标方法提交到另一条线程,新线程默认不会继承调用线程的事务上下文。

因此,排查时要把“方法调用关系”和“实际执行线程”分开看。代码上虽然仍是 createOrder() 调用 writeAuditAsync(),运行时却可能已经跨过线程边界;事务传播级别不会把原线程绑定的事务自动搬到新线程。

事务线程与异步线程的事务上下文边界

用运行时证据确认边界

先确认异步基础设施真的启用。@Async 依赖 Spring 的异步代理机制;没有 @EnableAsync 或等价配置时,方法不会按预期提交到异步执行器。下面是一个片段示例:它依赖项目中已有可用的 PlatformTransactionManager,但把异步与声明式事务开关都显式写出,便于直接验证。

java
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.scheduling.annotation.Async;
import org.springframework.scheduling.annotation.EnableAsync;
import org.springframework.transaction.annotation.EnableTransactionManagement;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.transaction.support.TransactionSynchronizationManager;

@Configuration(proxyBeanMethods = false)
// 显式启用异步与声明式事务代理,让实验前置条件可见。
@EnableAsync
@EnableTransactionManagement
public class AsyncTxProbeConfig {

    // 两个服务必须作为独立 Spring Bean 参与代理,避免自调用绕过 @Async。
    @Bean
    OrderService orderService(AuditService auditService) {
        return new OrderService(auditService);
    }

    @Bean
    AuditService auditService() {
        return new AuditService();
    }

    public static class OrderService {
        private final AuditService auditService;

        public OrderService(AuditService auditService) {
            this.auditService = auditService;
        }

        @Transactional
        public void createOrder() {
            printState("outer");
            // 通过另一个 Spring Bean 的代理调用,@Async 才有机会切换线程。
            auditService.writeAuditAsync();
        }
    }

    public static class AuditService {
        // 故意不加 @Transactional,用来验证新线程默认不会继承调用方事务。
        @Async
        public void writeAuditAsync() {
            printState("async");
        }
    }

    private static void printState(String label) {
        System.out.printf("%s thread=%s, tx=%s%n",
                label,
                Thread.currentThread().getName(),
                TransactionSynchronizationManager.isActualTransactionActive());
    }
}

预期结果:从控制器、测试类或其他 Spring Bean 调用代理后的 OrderService.createOrder() 时,外层方法处于活动事务,而异步方法运行在另一条线程中且默认没有活动事务。一种典型输出如下,实际线程名和端口会随 Web 容器、执行器配置而变化。

text
outer thread=http-nio-<PORT>-exec-<ID>, tx=true
async thread=task-<ID>, tx=false

典型失效场景怎么定位

最常见的故障是:外层事务修改主数据后提交异步任务,异步线程很快完成自己的数据库写入,随后外层事务却因异常回滚。最终表现为“主数据没了,异步记录还在”。这不是事务偶发失效,而是两个线程从一开始就没有共享同一个事务边界。

线程池还会带来时间上的误判。任务“提交成功”不等于“已经开始执行”;即使异步任务启动时外层事务尚未结束,它也不会因此获得原线程的事务上下文。日志至少应同时记录线程名、任务提交或开始时刻,以及 isActualTransactionActive() 的结果。

如果给异步方法再加 @Transactional,它可以在异步线程中开启自己的事务;即使使用 REQUIRES_NEW,这个事务也仍然是独立事务,并不会加入调用方原来的线程绑定事务。

重新划分异步事务边界

是否异步,应该由一致性要求决定。必须与主业务数据原子成功或失败的数据库操作,应保留在同一个同步事务中;允许主事务成功后再处理的工作,可以在异步线程中使用自己的事务边界。

如果要求“只有主事务提交后任务才可见”,进程内场景可以用 @TransactionalEventListener(phase = TransactionPhase.AFTER_COMMIT) 在提交后触发处理;如果还要求应用崩溃、重启后也不能丢任务,更稳妥的做法是在主事务内写入 outbox 或任务表,再由异步消费者独立领取并处理。这样可靠性来自持久化记录,而不是尝试在线程之间共享事务。

排查顺序

遇到“异步事务没有生效”,按固定证据链检查即可:

  1. 确认 @EnableAsync 或等价异步基础设施已启用。
  2. 确认调用经过 Spring 代理,而不是对象内部自调用。
  3. 对比调用方与异步方法的线程名,确认是否真的发生线程切换。
  4. 在两侧分别记录 TransactionSynchronizationManager.isActualTransactionActive()。
  5. 最后再检查异步方法是否需要自己的 @Transactional,以及业务是否真正允许拆成两个事务。

只要证据显示“外层事务为真、线程已切换、异步线程事务为假”,问题就不是传播级别没有调对,而是事务边界已经被线程切换切开。接下来的修复重点应是重新定义一致性与异步边界。

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

目录与阅读设置

记录一个想法

排查跨线程与异步事务问题

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

登录哪都通