spring boot 3.0 移除了对传统 jta 实现（如 atomikos 5.x）的自动配置支持，但 atomikos 6.0+ 已全面适配 jakarta ee 9+ 和 spring boot 3，可通过专用 starter 实现可靠的跨库事务管理。
在微服务与多租户架构日益普及的背景下，单体应用中需操作多个独立数据库（如 PostgreSQL + MySQL）的场景并不少见。此时，本地事务（@Transactional）已无法保证 ACID 跨库一致性，必须引入分布式事务机制。虽然 Spring Boot 3.0 确实移除了对旧版 JTA 提供商（如 Atomikos 5.x、Bitronix）的原生支持（因 Jakarta EE 命名空间迁移及模块精简），但这不等于放弃 JTA——而是要求使用兼容 Jakarta EE 9+（即 jakarta.* 包路径）的新一代事务管理器。
Atomikos 6.0 是目前最成熟、官方明确支持 Spring Boot 3 的分布式事务解决方案。其核心优势包括：
- 完整支持 Jakarta Transactions 2.0（jakarta.transaction.*）；
- 提供专为 Spring Boot 3 设计的 starter：com.atomikos:transactions-spring-boot3-starter；
- 保留 XA 协议能力，可协调多个支持 XA 的 JDBC 数据源（如 PostgreSQL、MySQL、Oracle）；
- 内置恢复日志、故障转移与超时控制，生产就绪。
✅ 快速集成步骤如下：
-
添加依赖（Maven）：
<dependency><groupid>com.atomikos</groupid><artifactid>transactions-spring-boot3-starter</artifactid><version>6.0.0</version></dependency><!-- 各数据库对应的 JDBC 驱动（需启用 XA 支持） --><dependency><groupid>org.postgresql</groupid><artifactid>postgresql</artifactid></dependency><dependency><groupid>mysql</groupid><artifactid>mysql-connector-java</artifactid><scope>runtime</scope></dependency>
-
配置两个 XA 数据源（application.yml）：
spring: datasource: postgres: jdbc-url: jdbc:postgresql://localhost:5432/db1 username: user1 password: pass1 xa: data-source-class-name: org.postgresql.xa.PGXADataSource properties: serverName: localhost portNumber: 5432 databaseName: db1 mysql: jdbc-url: jdbc:mysql://localhost:3306/db2 username: user2 password: pass2 xa: data-source-class-name: com.mysql.cj.jdbc.MysqlXADataSource properties: url: jdbc:mysql://localhost:3306/db2 -
声明 JtaTransactionManager 并启用全局事务：
@Configuration @EnableTransactionManagement public class JtaConfig { @Bean @Primary public JtaTransactionManager transactionManager( @Qualifier("postgresXaDataSource") DataSource postgresDs, @Qualifier("mysqlXaDataSource") DataSource mysqlDs) { UserTransactionManager userTxManager = new UserTransactionManager(); userTxManager.setForceShutdown(false); UserTransaction userTx = new UserTransactionImp(); userTx.setTransactionManager(userTxManager); JtaTransactionManager jtaTxManager = new JtaTransactionManager(); jtaTxManager.setTransactionManager(userTxManager); jtaTxManager.setUserTransaction(userTx); jtaTxManager.setAllowCustomIsolationLevels(true); return jtaTxManager; } }
⚠️ 关键注意事项：
- ✅ 所有参与数据库必须启用 XA 支持（如 MySQL 需开启 xa_engine=ON，PostgreSQL 默认支持）；
- ❌ 不要混用 @Transactional（Spring 的 PlatformTransactionManager）与 JTA —— 必须统一使用 JtaTransactionManager；
- ⚠️ Atomikos 6.x 默认将事务日志写入 ./transaction_logs/，请通过 com.atomikos.icatch.log_base_name 等属性配置高可用存储路径；
- ? 性能敏感场景需权衡：XA 两阶段提交会带来额外延迟与锁持有时间，建议优先评估 SAGA、TCC 或事件最终一致性等轻量替代方案。
综上，Atomikos 6.0 + transactions-spring-boot3-starter 是当前 Spring Boot 3.0 下管理多数据库分布式事务最直接、稳定且社区验证充分的技术路径。它延续了传统 XA 的强一致性保障，同时完全契合 Jakarta EE 9+ 生态，是平滑升级至 Spring Boot 3 的首选 JTA 方案。
