Java中多数据源事务通过Atomikos实现，核心是用JTA规范统一管理多个XA数据源的分布式事务；需配置XA数据源、设置唯一uniqueResourceName、启用UserTransactionManager与UserTransaction，并使用JtaTransactionManager和@Transactional确保跨库ACID。
Java 中多数据源事务通过 Atomikos 实现，核心是用 JTA 规范统一管理多个 XA 数据源的分布式事务。Atomikos 作为轻量级开源 JTA 事务管理器，不依赖应用服务器，可嵌入 Spring Boot 等环境，让跨库操作（如 MySQL + PostgreSQL）具备 ACID 保障。
配置多个 XA 数据源
每个数据源需封装为 XADatasource 实现类（如 MysqlXADataSource、PGXADataSource），再交由 Atomikos 包装成 AtomikosDataSourceBean（即 UserTransactionManager 可识别的 XA 资源）：
- MySQL 示例：用
com.mysql.cj.jdbc.MysqlXADataSource，设置url、user、password - PostgreSQL 示例：用
org.postgresql.xa.PGXADataSource，显式开启prepareThreshold=0避免非 XA 模式降级 - 每个
AtomikosDataSourceBean必须设置唯一uniqueResourceName（如mysql-ds、pg-ds），这是 Atomikos 识别资源的关键
启用 JTA 事务管理器
声明 UserTransactionManager 和 UserTransaction Bean，让 Spring 容器能获取全局事务上下文：
-
UserTransactionManager是 Atomikos 的核心服务，负责事务生命周期（begin/commit/rollback）和两阶段提交协调 -
UserTransaction是标准 JTA 接口实现，供业务代码调用begin()、commit()，或交由@Transactional自动代理 - Spring Boot 中推荐使用
JtaTransactionManager（传入上述两个 Bean），替代默认的DataSourceTransactionManager
声明式事务控制跨数据源操作
在 Service 方法上加 @Transactional，确保方法内对多个 JdbcTemplate 或 EntityManager 的操作运行在同一个 JTA 事务中：
立即学习“Java免费学习笔记（深入）”；
- 所有 DAO 层必须使用对应数据源的
JdbcTemplate或EntityManagerFactory，且不能混用非 XA 数据源 - 事务方法内若抛出未捕获的运行时异常（
RuntimeException）或Error，JTA 会自动回滚全部分支 - 避免在事务方法中手动调用
Connection.commit()或关闭连接——这会破坏 XA 协议，导致部分提交
注意 XA 兼容性与常见问题
并非所有数据库和驱动都开箱支持 XA，需主动验证和调优：
- 确认数据库已启用 XA（MySQL 8.0+ 默认支持；PostgreSQL 需
max_prepared_transactions > 0） - 驱动版本要匹配：MySQL Connector/J 8.0.28+、PostgreSQL JDBC 42.6.0+ 对 XA 支持更稳定
- Atomikos 日志目录（
com.atomikos.icatch.output_dir）必须可写，否则事务日志无法落盘，重启后无法恢复 - 慎用
PROPAGATION_REQUIRES_NEW：它会挂起当前 JTA 事务，启动新事务，导致跨数据源操作不再受同一全局事务保护
不复杂但容易忽略。关键不是堆配置，而是确保每个环节都在 XA 轨道上：数据源是 XA 的、事务管理器是 JTA 的、业务代码没绕过容器接管连接。
