Java中跨库事务实现强一致性必须采用JTA+XA方案，即通过JTA事务管理器协调多个启用XA支持的数据库资源，执行两阶段提交（2PC），而非依赖Spring默认单数据源事务机制。
Java 中跨库事务要实现强一致性，必须绕过 Spring 默认的单数据源事务管理机制，改用 JTA（Java Transaction API）规范 + XA 协议协调多个数据库资源。核心不是“加个注解就能跨库”，而是让所有参与库都成为可被统一调度的 XA 资源，并由 JTA 事务管理器执行两阶段提交（2PC）。以下关键点缺一不可：
数据库层必须启用 XA 支持
MySQL、Oracle、PostgreSQL 等主流数据库默认不开启 XA 功能，需手动确认并配置：
- MySQL：检查
have_xa变量是否为YES（SHOW VARIABLES LIKE 'have_xa';），5.7+ 版本通常默认支持；若使用云数据库（如阿里云 RDS），需确认控制台是否开启“XA 事务”开关 - Oracle：确保数据库启用了
ENABLED状态的 XA（SELECT * FROM V$OPTION WHERE PARAMETER = 'XAVIEW';返回 TRUE），且用户拥有SELECT ANY TABLE和FORCE TRANSACTION权限 - PostgreSQL：从 10 版本起原生支持 XA，但需使用
pgjdbc-ng或官方postgresql-XA驱动，普通 jdbc 驱动不支持
驱动与数据源必须是 XA-aware 的
普通 JDBC 驱动无法参与 XA 协调，必须使用数据库厂商提供的 XA 数据源类：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- MySQL：用
com.mysql.cj.jdbc.MysqlXADataSource（8.0+ 驱动），不能用com.mysql.jdbc.Driver - Oracle：必须用
oracle.jdbc.xa.client.OracleXADataSource，且驱动版本需匹配数据库（如 Oracle 19c 推荐 ojdbc8.jar） - PostgreSQL：推荐
com.impossibl.postgres.systems.XADataSource（pgjdbc-ng）或官方org.postgresql.xa.PGXADataSource - Spring Boot 中禁用 HikariCP/Druid 封装 XA 数据源——
spring-boot-starter-jta-atomikos内置的AtomikosDataSourceBean才是正确载体
应用层需集成 JTA 事务管理器
Spring 的 @Transactional 默认绑定 DataSourceTransactionManager，只管一个库。要跨库，必须切换为 JtaTransactionManager 并接入 Atomikos（生产首选）或 Narayana：
立即学习“Java免费学习笔记（深入）”；
- Maven 引入：
spring-boot-starter-jta-atomikos（Spring Boot 3.x 已适配 Jakarta EE 9+） - YAML 配置中每个数据源显式声明
xa.data-source-class-name，例如：spring: datasource: db1: xa: data-source-class-name: com.mysql.cj.jdbc.MysqlXADataSource db2: xa: data-source-class-name: oracle.jdbc.xa.client.OracleXADataSource - 业务方法上标注
@Transactional即可——此时它由 JTA 管理器接管，自动传播到所有已注册的 XA 数据源
事务行为验证与常见失效点
配置完成后必须实测回滚逻辑，因为很多问题静默发生：
- 若一个库写入成功、另一个抛异常却未回滚，大概率是某个数据源没走 XA 流程（比如误用了非 XA 驱动，或事务管理器未生效）
- Oracle 场景下特别注意：JVM 启动参数需加
-Doracle.jdbc.useXa=true，否则部分驱动会跳过 XA 分支 - 日志里搜索
TwoPhaseCommit或prepare phase关键字，确认 Atomikos 真正执行了两阶段提交流程 - 不要在同一个事务内混用 JPA/Hibernate 和原生 JDBC 操作——Hibernate Session 绑定的连接可能未纳入 XA 上下文，建议统一用 JdbcTemplate 或 MyBatis XA 兼容模式
