JTA+Atomikos设置10秒事务超时不生效仍等待300秒问题

问题现象 #

调整默认300秒事务超时的配置始终不生效，事务必须等待满300秒才会触发超时。

预期配置目标 #

• UserTransaction 超时时间设置为10秒
• UserTransactionManager 超时时间设置为10秒

原有配置代码 #

UserTransactionImp userTransaction = new UserTransactionImp();
userTransaction.setTransactionTimeout(10);

// ...

UserTransactionManager transactionManager= new UserTransactionManager();
transactionManager.setTransactionTimeout(10); // 原作者备注：已在UserTransaction上设置该值，此处配置可能非必须

// ...

JtaTransactionManager jtaTransactionManager = new JtaTransactionManager(userTransaction,transactionManager);

// ...

TransactionTemplate templ = new TransactionTemplate(jtaTransactionManager, new DefaultTransaction());

templ.execute(callback -> {
  // 数据库更新逻辑
})

复现步骤 #

1. 通过SQLDeveloper锁定数据库中的某一行数据
2. 启动应用程序，尝试更新同一行被锁定的数据
3. 应用程序持续阻塞等待行锁释放
4. 等待满300秒后才最终触发事务超时
   原有配置预期10秒触发事务超时，实际始终等待300秒才触发。

根因与修复方案 #

失效根因 #

直接在实例化后的UserTransactionImp、UserTransactionManager对象上调用setTransactionTimeout(10)不生效，核心有两点：

1. Spring的JtaTransactionManager在每次开启事务时，会主动调用底层UserTransaction的setTransactionTimeout方法，覆盖你提前设置的默认值。未显式配置JtaTransactionManager的超时属性时，它不会传递10秒的超时值给Atomikos，最终 fallback 到默认300秒的配置。
2. Atomikos存在全局最大超时限制参数com.atomikos.icatch.max_timeout，默认值为300000毫秒（即300秒），所有超过该值的超时配置都会被强制截断为300秒，这也是很多场景下超时卡300秒的常见诱因。

注意：如果配置的事务超时值大于com.atomikos.icatch.max_timeout，配置不会生效，会被Atomikos自动截断为max_timeout对应的数值。

修复步骤 #

1. 删除UserTransactionImp、UserTransactionManager实例上单独设置超时的代码，直接在JtaTransactionManager上配置默认超时，该值会在事务开启时正确传递给Atomikos：

   JtaTransactionManager jtaTransactionManager = new JtaTransactionManager(userTransaction,transactionManager);
   // 设置全局默认事务超时为10秒
   jtaTransactionManager.setDefaultTimeout(10);
   

2. 若需要给单个事务单独指定超时，直接在TransactionTemplate或@Transactional注解上设置即可，无需修改Atomikos底层对象配置：

   // 给当前事务模板单独设置10秒超时
   templ.setTimeout(10);
   

3. 检查Atomikos全局配置，显式指定参数避免默认值兜底干扰：

   # 全局默认JTA事务超时，单位：秒
   com.atomikos.icatch.default_jta_timeout=10
   # 单事务允许设置的最大超时，单位：毫秒，按需设置为比业务需要的超时值更大即可
   com.atomikos.icatch.max_timeout=300000
   

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