spring boot 3.0 移除了对传统 jta 实现（如 atomikos 5.x）的自动配置支持，但 atomikos 6.0+ 已全面适配 jakarta ee 9+ 和 spring boot 3，可通过官方 starter 实现可靠的跨库事务管理。
在微服务与多数据源架构日益普及的背景下，Spring Boot 3.0 对分布式事务的支持发生了重要演进：原生 ChainedTransactionManager 已被弃用，且 Spring Boot 不再内置集成旧版 JTA 提供商（如 Atomikos 5.x 或 Bitronix）。但这并不意味着 Spring Boot 3 无法支持跨数据库事务——关键在于选用兼容 Jakarta EE 9+ 规范的现代事务管理器。
目前最成熟、官方明确支持 Spring Boot 3 的方案是 Atomikos Transactions Essentials 6.0+。该版本已完成向 Jakarta EE 命名空间（jakarta.transaction.*）的全面迁移，完全适配 Spring Boot 3 的类路径、依赖注入与自动配置机制。
✅ 推荐实践步骤如下：
-
添加官方 Spring Boot 3 兼容 Starter（Maven）：
<dependency> <groupId>com.atomikos</groupId> <artifactId>transactions-spring-boot3-starter</artifactId> <version>6.0.0</version> </dependency>
配置多数据源（示例：PostgreSQL + MySQL）
确保每个 DataSource 使用 AtomikosDataSourceBean 包装，并启用 XA 支持（需对应数据库驱动支持 XA，如 postgresql:42.6.0+、mysql:mysql-connector-java:8.0.33+）：
@Bean
@Primary
public DataSource postgresDataSource() {
AtomikosDataSourceBean ds = new AtomikosDataSourceBean();
ds.setUniqueResourceName("postgres");
ds.setXaDataSourceClassName("org.postgresql.xa.PGXADataSource");
ds.setPoolSize(5);
Properties props = new Properties();
props.setProperty("serverName", "localhost");
props.setProperty("portNumber", "5432");
props.setProperty("databaseName", "db1");
props.setProperty("user", "user1");
props.setProperty("password", "pass1");
ds.setXaProperties(props);
return ds;
}-
声明全局 JTA 事务管理器
Atomikos 6.0 starter 会自动配置 JtaTransactionManager，无需手动定义。你只需在业务方法上使用标准 @Transactional：
@Service
public class OrderService {
@Transactional // 自动参与 JTA 全局事务
public void placeOrder(Order order, Payment payment) {
orderRepository.save(order); // 写入 PostgreSQL
paymentRepository.save(payment); // 写入 MySQL
// 任一失败 → 两库均回滚
}
}⚠️ 注意事项：
- 所有参与事务的数据源必须为 XA-capable，且驱动版本需满足 Jakarta EE 兼容性要求；
- 避免混合使用 @Transactional（JTA）与本地事务（如 DataSourceTransactionManager），否则将导致事务上下文不一致；
- 生产环境建议启用 Atomikos 日志（com.atomikos.icatch.output_dir）用于故障排查；
- 若架构允许，优先考虑最终一致性+Saga 模式作为替代方案（尤其在跨服务场景），以降低强一致性带来的复杂度与性能损耗。
综上，Atomikos 6.0 + transactions-spring-boot3-starter 是当前 Spring Boot 3.0 下实现多数据库分布式事务最直接、稳定且官方支持的路径——它延续了 XA 两阶段提交的可靠性，同时完成了现代化技术栈对齐。
