独立JPA+Hibernate应用中Narayna版JTA UserTransaction回滚失效问题

问题场景 #

在独立JPA+Hibernate应用中，使用Narayna实现的JTA UserTransaction执行回滚操作后，实体仍被持久化到数据库，回滚未生效。

核心代码片段 #

try(EntityManager em = entityManagerFactory.createEntityManager()) {
        TestEntity e = new TestEntity();
        UserTransaction tx = com.arjuna.ats.jta.UserTransaction.userTransaction();
        tx.begin();
        em.persist(e);
        tx.rollback();
    }

相关persistence.xml配置 #

<properties>
    <property name="jakarta.persistence.jdbc.url" value="jdbc:mariadb://localhost:3307/test"/>
    <property name="jakarta.persistence.jdbc.user" value="root"/>
    <property name="jakarta.persistence.jdbc.password" value="test"/>
    <property name="jakarta.persistence.jdbc.driver" value="org.mariadb.jdbc.Driver"/>
    <property name="jakarta.persistence.schema-generation.database.action" value="create" />
    <property name="hibernate.dialect" value="org.hibernate.dialect.MariaDBDialect"/>
    <property name="hibernate.show_sql" value="true" />
    <property name="hibernate.hbm2ddl.charset_name" value="UTF-8" />
    <property name="hibernate.transaction.jta.platform" value="JBossTS"/>
    <property name="hibernate.transaction.coordinator_class" value="jta"/>
</properties>

问题根源：当前persistence-unit的transaction-type为RESOURCE_LOCAL（本地事务模式），EntityManager的数据库连接由Hibernate自行创建，未被Narayna的JTA事务管理器接管，导致回滚指令无法作用于该连接。

解决步骤 #

1. 修改事务类型为JTA #

在persistence.xml中，将persistence-unit的transaction-type明确设置为JTA：

<persistence-unit name="YourPUName" transaction-type="JTA">
    <!-- 其他配置内容 -->
</persistence-unit>

2. 配置XA数据源 #

RESOURCE_LOCAL模式下的普通JDBC连接不支持JTA全局事务，必须改用XA兼容的数据源：

• 引入MariaDB的XA驱动依赖（以Maven为例）：

<dependency>
    <groupId>org.mariadb.jdbc</groupId>
    <artifactId>mariadb-java-client</artifactId>
    <version>3.3.3</version> <!-- 替换为适配的版本 -->
</dependency>

• 替换persistence.xml中的JDBC属性，配置XA数据源：

<properties>
    <property name="hibernate.transaction.jta.platform" value="org.hibernate.service.jta.platform.internal.JBossStandAloneJtaPlatform"/>
    <property name="hibernate.transaction.coordinator_class" value="jta"/>
    <!-- XA数据源配置 -->
    <property name="hibernate.connection.driver_class" value="org.mariadb.jdbc.Driver"/>
    <property name="hibernate.connection.url" value="jdbc:mariadb://localhost:3307/test"/>
    <property name="hibernate.connection.username" value="root"/>
    <property name="hibernate.connection.password" value="test"/>
    <property name="hibernate.connection.xa.datasource_class" value="org.mariadb.jdbc.MariaDbDataSource"/>
    <!-- 保留原有dialect、show_sql等配置 -->
</properties>

3. 让EntityManager参与JTA事务 #

在代码中添加joinTransaction()方法，将EntityManager关联到当前JTA事务上下文：

try(EntityManager em = entityManagerFactory.createEntityManager()) {
        TestEntity e = new TestEntity();
        UserTransaction tx = com.arjuna.ats.jta.UserTransaction.userTransaction();
        tx.begin();
        em.joinTransaction(); // 关键：让EntityManager加入当前JTA事务
        em.persist(e);
        tx.rollback();
    }

4. 确保Narayna事务服务初始化（独立应用） #

独立环境中需手动触发Narayna的事务管理器初始化，可在应用启动时添加：

// 初始化Narayna事务服务
com.arjuna.ats.jta.TransactionManager.transactionManager();

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