Oracle XA分布式事务在Spring Boot中需数据库端（distributed_transactions=10、授XA权限）、驱动层（ojdbc8+OracleXADataSource）、Spring配置（禁用DataSourceAutoConfiguration、显式配XA数据源）、事务管理器（Atomikos或Seata XA模式）四者严格对齐，任一缺失均导致prepare阶段静默失败并报Protocol violation。
Oracle XA 分布式事务在 Spring Boot 中能跑通，但前提是数据库端、驱动层、Spring 配置、事务管理器四者全部对齐——漏掉任一环，prepare 阶段就会静默失败，日志只报 java.sql.SQLException: Protocol violation，毫无线索。
Oracle 实例必须显式启用 XA 支持
即使 Java 侧所有配置都正确，Oracle 数据库未开启 XA 功能，连接会在 XA PREPARE 阶段直接断开。这不是 Spring 或 Atomikos 的问题，而是 Oracle 实例级限制。
- 确认
init.ora或spfile中已设置：distributed_transactions = 10（或更大值） - 检查当前会话是否允许 XA：
SELECT * FROM V$OPTION WHERE PARAMETER = 'Distributed Transaction Processing';，返回TRUE才有效 - 赋予用户 XA 权限：
GRANT SELECT ON SYS.DBA_PENDING_TRANSACTIONS TO your_user;和GRANT FORCE ANY TRANSACTION TO your_user; - 注意：Oracle 12c 及以后版本默认关闭 XA，仅靠 JDBC URL 参数（如
allowMultiQueries=true）无法开启
Spring Boot 必须禁用自动数据源配置并手动注册 XA DataSource
spring-boot-starter-jdbc 的自动配置会抢在 Atomikos 初始化前创建普通 DataSource，导致 XA 事务管理器绑定失败，最终所有 @Transactional 都降级为本地事务。
- 在
application.yml中强制排除：spring.autoconfigure.exclude=org.springframework.boot.autoconfigure.jdbc.DataSourceAutoConfiguration - 不能用
DruidDataSource或HikariCP直接实例化，必须包装为 XA 兼容类型：oracle.jdbc.xa.client.OracleXADataSource - Atomikos 配置示例（Java Config）：
@Bean(name = "oracleXaDataSource") public AtomikosDataSourceBean oracleXaDataSource() { AtomikosDataSourceBean ds = new AtomikosDataSourceBean(); ds.setUniqueResourceName("oracle-xa"); ds.setXaDataSourceClassName("oracle.jdbc.xa.client.OracleXADataSource"); Properties props = new Properties(); props.setProperty("URL", "jdbc:oracle:thin:@//host:1521/ORCLPDB1"); props.setProperty("user", "scott"); props.setProperty("password", "tiger"); ds.setXaProperties(props); ds.setMinPoolSize(1); ds.setMaxPoolSize(5); return ds; }
JTA 事务管理器必须与 XA DataSource 绑定，且不能混用 AT 模式
Seata 的 AT 模式和 Oracle XA 完全不兼容——AT 依赖解析 SQL 生成 undo_log 表，而 Oracle 不支持该机制；强行启用会导致分支注册成功但全局提交卡死在 PhaseOne。
- 若使用 Seata，必须在
application.yml明确指定：seata.data-source-proxy-mode: XA（不是AT） - 同时在
file.conf中关闭 AT：service.disableGlobalTransaction = true，并设store.mode = "db"（TC 仍需 DB 存状态） - 若用 Atomikos，则必须配
spring-boot-starter-jta-atomikos，且PlatformTransactionManagerbean 必须返回JtaTransactionManager实例，而非DataSourceTransactionManager - 多数据源场景下，每个
@Transactional必须通过transactionManager属性指定对应管理器，例如：@Transactional(transactionManager = "oracleTransactionManager")
XA 分支事务的 commit/rollback 不能依赖 RM 上报
Oracle XA 的两阶段提交由数据库自身驱动完成，Seata RM 若误报“分支已提交”，TC 就会提前释放 XID 锁，导致后续全局事务无法推进。
- 务必在 Seata 客户端配置中关闭上报：
client.rm.report.success.enable = false - 确保
registry.conf中service.vgroupMapping.my_test_tx_group与应用侧一致，否则 TC 根本收不到分支注册请求 - 应用启动后，检查日志是否出现
register branch successfully+XID:字样；若只有注册日志、无后续branch-commit，大概率是report.success.enable = true导致 TC 提前结束流程
最容易被忽略的是 Oracle 实例的 distributed_transactions 参数和 Seata 的 report.success.enable 开关——前者让整个链路根本连不进 prepare 阶段，后者让链路卡在 commit 前一秒，两者错误现象高度相似，但根因完全不在同一层。
