Quarkus中配置事务超时遇异常及不生效问题求助

错误原因解析 #

@TransactionConfiguration仅能作用于事务入口方法（即触发事务的起始方法），嵌套事务方法上使用会抛出你遇到的异常。移到入口方法后超时未生效，通常是注解使用细节或事务上下文覆盖导致的。

正确设置方式 #

1. 入口方法注解组合（推荐）

确保在事务的最上层入口方法上同时使用@Transactional和@TransactionConfiguration，注意导入正确的Quarkus专属注解包：

import io.quarkus.narayana.jta.runtime.annotation.TransactionConfiguration;
import jakarta.transaction.Transactional;

public class PlanService {
    // 事务入口方法：必须是触发事务的第一个方法
    @Transactional
    @TransactionConfiguration(timeout = 360) // 设置超时为360秒
    public void processPlanSave() {
        // 调用业务方法，共享同一事务上下文
        savePlan();
    }

    // 业务方法无需额外事务注解
    private void savePlan() {
        // 执行持久化逻辑，保留em.flush()/em.detach()优化
    }
}

• 注意：如果入口方法被其他带@Transactional的方法调用，实际事务入口是上层方法，需将超时配置移到那个最上层方法。

2. 编程式事务控制（灵活替代）

如果无法修改入口方法，可通过UserTransaction手动控制事务超时：

import jakarta.transaction.UserTransaction;
import jakarta.inject.Inject;

public class PlanService {
    @Inject
    UserTransaction userTransaction;

    public void savePlanWithCustomTimeout() throws Exception {
        userTransaction.setTransactionTimeout(360);
        userTransaction.begin();
        try {
            // 执行savePlan业务逻辑 + em.flush()/em.detach()
            userTransaction.commit();
        } catch (Exception e) {
            userTransaction.rollback();
            throw e;
        }
    }
}

验证超时生效 #

可在事务中添加Thread.sleep(61000)（超过默认1分钟），若触发事务超时异常，则说明配置生效。

注意事项 #

Quarkus基于Narayana实现JTA，事务注解生效逻辑与Wildfly存在差异，必须确保超时配置在事务的起始入口点。em.flush()和em.detach()的性能优化操作可正常保留，不影响事务超时设置。

内容的提问来源于stack exchange，提问作者med.b