Quarkus中异步调用@Transactional方法报ContextNotActiveException如何解决

异常核心原因 #

• 异步任务运行在自定义线程池的独立线程中，默认未激活CDI的请求/事务上下文，Hibernate依赖的RequestScopedSessionHolder无法获取有效实例，直接抛出上下文未激活异常
• 原代码中在同一个Bean内部调用@Transactional修饰的方法，不会触发CDI代理逻辑，事务注解本身不会生效，即使上下文正常也无法正常开启事务

步骤1：替换自定义线程池为Quarkus托管的ManagedExecutor #

不要使用自行创建的ThreadPoolExecutor，直接注入Quarkus提供的ManagedExecutor，它会自动将当前CDI上下文传播到异步执行的线程中，自动激活所需的上下文环境。你之前将事务方法移到独立Bean后问题未解决，就是因为异步线程的上下文没有正确传播导致的，替换为ManagedExecutor即可解决该问题。
代码示例：

@ApplicationScoped
public class Worker {
    // 注入Quarkus托管的执行器
    @Inject
    ManagedExecutor managedExecutor;

    // 注入事务处理的独立Bean
    @Inject
    TransactionService transactionService;

    public void process(Long id) {
        final Runnable runnable = () -> {
            transactionService.doATransaction(id);           
        };
        managedExecutor.execute(runnable);
    }
}

步骤2：事务方法独立到单独的Bean中确保走代理调用 #

创建独立的TransactionService Bean，将事务逻辑放在这个类中，通过注入的代理实例调用，确保@Transactional注解生效：

@ApplicationScoped
public class TransactionService {
    
    @Transactional
    public void doATransaction(Long id) {
        User user  = User.findById(id);
        // 其他事务逻辑
    }
}

可选替代方案：如果必须使用自定义线程池 #

如果有特殊需求必须使用自定义的线程池，可以通过Quarkus上下文传播工具手动包装任务，传递上下文到异步线程：

// 手动传递上下文到自定义线程池任务
Runnable wrappedTask = ContextPropagation.getContextManager().contextAwareRunnable(originalRunnable);
customExecutor.execute(wrappedTask);

内容的提问来源于stack exchange，提问作者bobby