Spring Boot 3.0 中实现多数据源分布式事务的推荐方案

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：

✅ 正确引入依赖（Maven）

    com.atomikos
    transactions-spring-boot3-starter
    6.0.0

⚠️ 注意：务必使用 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 的现代化适配，是平滑升级路径中的首选实践。