spring boot 3.0 移除了对传统 jta 实现（如旧版 atomikos）的自动配置支持，但通过 jakarta ee 兼容的 atomikos 6.0+ 及其专用 starter，仍可安全、高效地实现跨多数据库的分布式事务管理。
在 Spring Boot 3.0 中，由于全面迁移到 Jakarta EE 9+（包名从
java
x.* 升级为 jakarta.*），原有基于 Java EE 的 JTA 事务管理器（如 Atomikos Transactions Essentials ≤5.x）无法直接使用，且 Spring Data Commons 已废弃 ChainedTransactionManager —— 这意味着
本地事务编排（best-effort 1PC）不再被官方推荐用于生产级一致性保障
。
目前最成熟、社区验证有效的方案是：
采用 Atomikos Transactions Essentials 6.0+ 版本
，该版本已原生支持 Jakarta EE，并提供专为 Spring Boot 3 设计的 starter：
✅ 正确引入依赖（Maven）
⚠️ 注意：务必使用 transactions-spring-boot3-starter（非旧版 spring-boot-starter-jta-atomikos），后者不兼容 Jakarta EE，会在启动时抛出 ClassNotFoundException: javax.transaction.TransactionManager。
✅ 基础配置示例（application.yml）
✅ 启用全局事务（@Transactional）
只要所有数据源均通过 Atomikos AtomikosDataSourceBean（由 starter 自动配置）注册，@Transactional 即可协调两库的 prepare/commit/rollback，实现真正的 2PC 分布式事务语义。
AI Word
一款强大的 AI 智能内容创作平台，致力于帮助用户高效生成高质量、原创且符合 SEO 规范的各类文章。
下载
⚠️ 重要注意事项
性能与复杂度权衡
：JTA 2PC 会带来显著性能开销和部署复杂度，仅在强一致性不可妥协的场景（如金融核心账务）使用；多数业务建议优先考虑 Saga 模式或本地消息表等最终一致性方案。
XA 驱动要求
：确保所用数据库驱动支持 XA（如
mysql
-connector-j ≥8.0.28、postgresql ≥42.5.0），并在连接 URL 中启用 XA（如 ?allowPublicKeyRetrieval=true&serverTimezone=UTC）。
事务边界清晰
：避免在事务方法中调用非事务性远程服务或产生不可回滚的副作用（如发邮件、写文件）。
综上，
Atomikos 6.0 + transactions-spring-boot3-starter 是当前 Spring Boot 3.0 官方生态中唯一被明确支持、生产就绪的多数据源分布式事务解决方案
。它延续了 JTA 的可靠性，同时完成了 Jakarta EE 的现代化适配，是平滑升级路径中的首选实践。
com.atomikos
transactions-spring-boot3-starter
6.0.0
spring:
datasource:
primary:
jdbc-url: jdbc:mysql://localhost:3306/db1
username: user1
password: pass1
secondary:
jdbc-url: jdbc:postgresql://localhost:5432/db2
username: user2
password: pass2
atomikos:
transaction:
max-timeout: 300000
default-jta-timeout: 60000@Service
public class OrderService {
@Transactional // 自动参与 Atomikos JTA 事务上下文
public void placeOrder(Order order) {
orderRepository.save(order); // 写入 MySQL
inventoryService.deductStock(order); // 调用 PostgreSQL 数据源操作
}
}