spring boot 3.0 移除了对传统 jta 实现（如旧版 atomikos）的自动配置支持，但通过 jakarta ee 兼容的 atomikos 6.0+ 及其专用 starter，仍可安全、高效地实现跨多数据库的分布式事务管理。
在 Spring Boot 3.0 中，由于全面迁移到 Jakarta EE 9+（包名从 javax.* 升级为 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：
将 LaTeX（.tex）学术论文转换为 Word（.docx），支持可编辑的 OMML 公式、原生 Word 表格、嵌入图形、IEEE 双栏排版及参考文献
✅ 正确引入依赖（Maven）
<dependency>
<groupId>com.atomikos</groupId>
<artifactId>transactions-spring-boot3-starter</artifactId>
<version>6.0.0</version>
</dependency>⚠️ 注意：务必使用 transactions-spring-boot3-starter（非旧版 spring-boot-starter-jta-atomikos），后者不兼容 Jakarta EE，会在启动时抛出 ClassNotFoundException: javax.transaction.TransactionManager。
✅ 基础配置示例（application.yml）
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✅ 启用全局事务（@Transactional）
@Service
public class OrderService {
@Transactional // 自动参与 Atomikos JTA 事务上下文
public void placeOrder(Order order) {
orderRepository.save(order); // 写入 MySQL
inventoryService.deductStock(order); // 调用 PostgreSQL 数据源操作
}
}只要所有数据源均通过 Atomikos AtomikosDataSourceBean（由 starter 自动配置）注册，@Transactional 即可协调两库的 prepare/commit/rollback，实现真正的 2PC 分布式事务语义。
⚠️ 重要注意事项
- 性能与复杂度权衡：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 的现代化适配，是平滑升级路径中的首选实践。
