分布式事务（可选接入）

基于 Apache Seata 2.6.0 AT 模式的可选接入材料。项目默认不启用：本目录不是 Maven 模块，不参与默认构建，主工程的依赖、配置、业务表都不受影响。

接入后，master、slave 数据源保持不变、不参与全局事务，只有示例的 seata_order、seata_account 两个数据源由 Dynamic Datasource 包装 Seata 代理。示例 DemoSeataTradeService#placeOrder 在同一个进程中，先在订单库创建订单、再在账户库扣减余额，两个库的操作要么都成功，要么都回滚。

Seata Server 的启动、配置、验证及使用限制，请阅读项目文档《分布式事务》，本文只列出材料及分支适用范围：

• 单体项目 ruoyi-vue-pro：https://doc.iocoder.cn/distributed-transaction/
• 微服务项目 yudao-cloud：https://cloud.iocoder.cn/distributed-transaction/

1. 材料清单

文件	说明	目标位置
sql/mysql/demo_seata.sql	创建 2 个演示库，各一张示例表 + undo_log 表	在 MySQL 中执行
dependencies.xml	Maven 依赖片段	yudao-module-system/pom.xml（全局事务入口所在的模块，yudao-server 通过已有的模块依赖传递获得）
seata.yaml	seata_order、seata_account 数据源，以及 Seata 客户端的配置片段	合并到 yudao-server 的 application-{profile}.yaml；seata: false 只追加到已经存在的数据源，没有 slave 时不要复制 slave 段
src/main/java/.../system/seatademo/	订单 DO、Mapper、Service，以及全局事务入口 DemoSeataTradeService	yudao-module-system/src/main/java 的同名包
src/main/java/.../infra/seatademo/	账户 DO、Mapper、Service	yudao-module-infra/src/main/java 的同名包

订单放在 yudao-module-system、账户放在 yudao-module-infra，是因为 yudao-module-system 已经依赖 yudao-module-infra，可以直接调用账户 Service；与微服务项目 yudao-cloud 中「system-server 发起、infra-server 参与」的示例保持一致。

2. 分支适用范围

目前只有 master-jdk17 分支提供本目录的材料；master、master-jdk25 分支请先从 master-jdk17 分支的 script/seata/ 获取，同步到对应分支后，也可以直接从当前分支获取。

本目录的材料适用于 master（JDK 8 + Spring Boot 2.7.18）、master-jdk17（Spring Boot 3.5.15）、master-jdk25（Spring Boot 4.1.2）三个分支，接入步骤相同，兼容要点如下：

要点	说明
Seata 坐标	只使用 org.apache.seata:seata-spring-boot-starter:2.6.0，它自带 Dynamic Datasource 4.6.0 需要的 io.seata 兼容类，不要再引入 io.seata:* 坐标
Druid	排除 Seata 传递的 druid 1.2.25，继续使用项目 Druid starter 提供的版本
Jackson 2	Seata 的 undo_log 序列化需要 jackson-databind、jackson-datatype-jsr310；master-jdk25 的 Spring Boot 4 默认使用 Jackson 3，必须添加，其它分支添加后版本不变
示例代码	只使用 Java 8 语法，使用构造方法注入，不引用 javax、jakarta 包，三个分支无需修改

@GlobalTransactional 注解的包名是 org.apache.seata.spring.annotation。全局事务入口必须是组件扫描的 @Service 等 Bean，Seata 2.6 不会增强 @Bean 方法定义的 Bean。