Payara Micro批处理报错：本地事务已含1个非XA资源无法添加更多

问题现象 #

persistence.xml配置的ORM连接池可正常工作，但使用Jakarta Batch执行批处理时出现报错：

[#|2023-06-01T17:54:23.626+0200|SEVERE||javax.enterprise.resource.resourceadapter.com.sun.enterprise.resource.rm|_ThreadID=120;_ThreadName=concurrent/__defaultManagedExecutorService-managedThreadFactory-Thread-4;_TimeMillis=1685634863626;_LevelValue=1000;|RAR5029:Unexpected exception while registering component
java.lang.IllegalStateException: Local transaction already has 1 non-XA Resource: cannot add more resources.
    at com.sun.enterprise.transaction.JavaEETransactionManagerSimplified.enlistResource(JavaEETransactionManagerSimplified.java:418)
    at com.sun.enterprise.resource.rm.ResourceManagerImpl.registerResource(ResourceManagerImpl.java:152)
    at com.sun.enterprise.resource.rm.ResourceManagerImpl.enlistResource(ResourceManagerImpl.java:112)
    at com.sun.enterprise.resource.pool.PoolManagerImpl.getResource(PoolManagerImpl.java:211)
    at com.sun.enterprise.connectors.ConnectionManagerImpl.getResource(ConnectionManagerImpl.java:360)
    at com.sun.enterprise.connectors.ConnectionManagerImpl.internalGetConnection(ConnectionManagerImpl.java:307)
    at com.sun.enterprise.connectors.ConnectionManagerImpl.allocateConnection(ConnectionManagerImpl.java:196)
    at com.sun.enterprise.connectors.ConnectionManagerImpl.allocateConnection(ConnectionManagerImpl.java:171)
    at com.sun.enterprise.connectors.ConnectionManagerImpl.allocateConnection(ConnectionManagerImpl.java:166)
    at com.sun.gjc.spi.base.AbstractDataSource.getConnection(AbstractDataSource.java:113)
    at fish.payara.jbatch.persistence.rdbms.JBatchJDBCPersistenceManager.getConnection(JBatchJDBCPersistenceManager.java:472)

随后出现警告：

[#|2023-06-01T17:54:23.627+0200|WARNING||javax.enterprise.resource.resourceadapter.com.sun.enterprise.resource.pool|_ThreadID=120;_ThreadName=concurrent/__defaultManagedExecutorService-managedThreadFactory-Thread-4;_TimeMillis=1685634863627;_LevelValue=900;|RAR7132: Unable to enlist the resource in transaction. Evicting resource from pool. Pool name: [ H2Pool ]|#]

问题原因推测 #

同一事务内，Jakarta Batch默认使用H2Pool写入批处理元数据，同时业务代码通过persistence.xml配置的ORM连接池写入业务数据，两个非XA资源无法在同一个本地事务中同时被登记，导致冲突。

解决方案 #

1. 将业务连接池改为XA模式 #

修改业务数据源的配置，启用XA事务支持：

• 在Payara管理控制台找到你的数据源，切换到「事务」标签页，将「事务支持」设置为XA
• 确保对应JDBC驱动支持XA（主流数据库驱动如MySQL、PostgreSQL均提供XA驱动）
• 确认persistence.xml中的事务类型为JTA（通常已配置，可再次核对）：

  <persistence-unit name="YourPU" transaction-type="JTA">
      <!-- 其他配置项 -->
      <jta-data-source>java:app/jdbc/YourXADatasource</jta-data-source>
  </persistence-unit>
  

此方案无需修改批处理配置，但需确保数据库和驱动支持XA，XA事务会带来轻微性能开销。

2. 配置Jakarta Batch使用业务连接池 #

让批处理复用业务数据源，避免多连接池冲突，操作步骤如下：

1. 配置批处理数据源：
   打开Payara管理控制台，进入「配置」->「服务器配置」->「微Profile」->「Batch」，在「JDBC数据源JNDI名称」栏填入业务数据源的JNDI（例如java:app/jdbc/YourBusinessDatasource），保存后重启Payara服务。
2. 初始化批处理元数据表：
   在业务数据库中执行Payara提供的批处理元数据建表脚本，脚本位于payara_install_dir/appserver/lib/install/databases/目录下，选择对应数据库的脚本（如create-tables-postgresql.sql）执行。
3. 验证配置：
   重新运行批处理任务，此时批处理元数据和业务数据将使用同一个连接池，避免事务冲突。

3. 其他可选方案 #

• 分离事务边界：将批处理元数据操作和业务数据操作放在不同事务中，比如业务事务提交后再触发批处理，或在批处理ItemWriter中手动管理事务（增加复杂度，不推荐）。
• 启用最后资源提交优化：Payara支持「最后资源提交优化」，允许一个事务中包含一个XA资源和一个非XA资源。可在控制台「事务服务」中启用此选项，但该方式不属于标准JTA规范，存在数据一致性风险，需谨慎使用。

内容的提问来源于stack exchange，提问作者Maarten van Leunen