分布式事务Seata使用：3个方法

▌ 技术引导

Seata 是一个开源的分布式事务解决方案，2024 年起在微服务架构中广泛应用。我见过几个项目在引入 Seata 后，事务一致性问题得到了有效控制，但过程并不简单。实际项目中，Seata 的使用需要结合业务场景做出取舍，不能一概而论。我亲身踩过坑，比如在高并发下未正确配置事务分组，导致事务回滚失败；或者在使用 TCC 模式时，未实现幂等性，导致重复提交。经验告诉我，Seata 的三种核心方法：AT 模式、TCC 模式、Saga 模式，各有所长，也各有适用条件，必须根据具体业务逻辑来选择。在真实项目中，AT 模式是最常见的，但性能损耗较大；TCC 更适合强一致性要求的场景，但实现复杂；Saga 则适合长事务拆分，但需要开发者自行维护补偿逻辑。

我见过很多团队在使用 Seata 时，误以为只要引入依赖就能解决问题，结果事务在某些分支失败时，全局事务没有正确回滚。关键在于配置和事务边界划分。比如，使用 AT 模式时，如果没有在 transactionManager 配置中指定正确的数据库类型，可能造成事务日志无法持久化，最终导致事务异常。另外，在配置 file 或 registry 中，如果未正确设置事务组名，不同服务之间的事务将无法正确关联。这些细节在实际部署中容易被忽视，但一旦出问题，排查成本极高。我在实际中采用的方案是将事务组名统一配置在 Nacos 中，通过 env 变量传入，确保一致性。这也是很多项目中推荐的做法。

配置 Seata 的事务分组和 registry 地址是关键，但不是全部。我见过一些团队在使用 Seata 的时候，因为未正确关闭事务，导致资源泄露。例如，在 Spring Boot 中，如果使用 @GlobalTransactional 注解，但服务调用链未正确结束，事务可能一直处于悬挂状态。这种情况下，需要确保所有分支事务在本地事务完成后正常提交或回滚。另外，Seata 的 TC 服务需要独立部署，这点非常重要，否则多个微服务实例可能无法正确获取全局事务的编号，导致事务失败。我在部署 TC 时通常会将它放在 Kubernetes 中，配置为单节点，保证其高可用和稳定性。

在使用 AT 模式时，我亲眼见过某个业务在 MySQL 上运行，但没有开启 binlog，导致 Seata 无法正确捕获事务日志，最终事务协调失败。这是很多团队容易忽略的问题。AT 模式依赖数据库的 binlog 来实现回滚，因此数据库的配置必须正确。另外，如果数据库有读写分离的架构，Seata 的 AT 模式需要特别注意事务日志写入的节点是否与主库一致，否则可能引发数据不一致。我在一个电商项目中使用 AT 模式时，曾因为主从延迟，导致部分事务回滚失败。后来通过在 Seata 的配置中设置事务日志记录的数据库为从库，问题得到了缓解。这只是其中一个案例，还有不少类似的细节值得重视。

在 TCC 模式中，我见过最常见的是补偿事务未正确实现，导致业务在部分失败后无法恢复。比如，某个支付系统在 TCC 模式中，准备阶段执行了扣款操作，但提交阶段因为网络问题，未能成功通知下游服务，导致补偿逻辑未触发。为了避免类似问题，我在实际开发中会将 TCC 的准备、提交、取消阶段分别封装为独立的接口，并在每个接口中加入幂等性校验。同时，事务补偿需要在全局事务异常时被正确调用，因此需要在 Seata 的配置中设置事务回滚的触发机制，例如在 Spring 中配置 rollbackOnly 属性，确保事务异常时能够触发补偿逻辑。

▌ 技术参考

一 技术背景与核心概念

Seata 是阿里巴巴开源的分布式事务框架，2024 年后成为业内主流方案之一。它支持 AT、TCC、Saga 三种模式，分别适用于不同场景。AT 模式基于两阶段提交，通过数据库的 binlog 实现事务回滚；TCC 模式强调事务的补偿机制，适合强一致性要求；Saga 模式则是通过多个本地事务的顺序执行和回滚来实现最终一致性。这三种方法各有优劣，在实际项目中需要结合业务需求进行选择。AT 模式是最常用的，因为它对开发者侵入性较低，但性能损耗较大；TCC 模式需要自行实现补偿逻辑，但可以更精细地控制事务行为；Saga 模式适合长事务场景，但需要开发者处理复杂的补偿流程。我见过很多项目在初期使用 AT 模式，后期因性能问题切换为 TCC 或 Saga。

二 具体操作方法或配置步骤

在使用 Seata 的 AT 模式时，需要在 Spring Boot 项目中引入 Seata 的 starter 依赖，比如 spring-cloud-starter-seata-at-order。同时，需要在配置文件中设置 transactionManager 的类型，例如 setting.transactionManagerType=AT。还需要指定数据库的连接信息，确保 Seata 能够正确访问数据库的 binlog。例如，配置文件中可以设置 spring.datasource.url=jdbc:mysql://localhost:3306/seata?useUnicode=true&characterEncoding=UTF-8&useSSL=false。如果使用 Nacos 作为配置中心，需要在 nacos.config.serverAddr 配置项中指定 Nacos 的地址。此外，事务组名的配置也非常重要，例如 seata.service.vgroupMapping.default_txgroup=lfra-rc。这些配置项需要在部署前仔细检查，否则可能导致事务无法正常协调。

三 常见踩坑场景与避坑方案

在使用 Seata 时，最常见的坑之一是事务分组未正确配置，导致服务间事务无法正确关联。例如，某个微服务在配置中使用了不同的事务组名，结果全局事务无法正确回滚。为了避免这个问题，我通常会将所有服务的事务组名统一配置为 default_txgroup，并确保在 Nacos 中设置正确的事务组名。另一个常见问题是事务日志未正确持久化，特别是在 MySQL 中未开启 binlog，导致 AT 模式无法正常回滚。这需要在数据库的配置文件中设置 log-bin=mysql-bin 和 server-id=1，确保 binlog 正确开启。此外，事务未正确关闭也会导致资源泄露，例如在 Spring 中未使用 @GlobalTransactional 注解，或者在服务调用链中未正确处理事务上下文，最终导致事务无法正确提交或回滚。这些细节需要在实际部署中反复验证，否则会给后续故障排查带来极大麻烦。

四 性能影响或效率对比

AT 模式虽然实现简单，但性能损耗较大，尤其是在高并发场景下。我见过一个电商项目在使用 AT 模式时，事务回滚操作导致数据库负载升高，响应时间增加。这是因为 Seata 需要记录事务日志，并在回滚时执行 undo SQL，这个过程会占用额外的数据库资源。相比之下，TCC 模式虽然实现复杂，但可以更精细化地控制事务行为，减少不必要的数据库操作。Saga 模式则适合长事务场景，但会带来额外的开发负担。我在实际项目中发现，当业务逻辑较复杂，事务边界较多时，TCC 或 Saga 会比 AT 更高效。不过，如果是简单的业务操作，AT 模式反而更节省开发成本。因此，必须根据具体业务场景选择合适的模式，不能一概而论。

五 适用场景与局限性

AT 模式适用于大多数基于数据库的业务场景，尤其是需要自动回滚的场景。比如，一个订单支付系统在 MySQL 上运行，使用 AT 模式可以保证支付、库存扣减、发货等操作的事务一致性。但 AT 模式在高并发下性能表现不佳，因为每次事务都需要记录日志并执行回滚操作。TCC 模式更适合需要强一致性的场景，比如金融系统中的转账操作，但需要开发者自行实现补偿逻辑，增加了开发复杂度。Saga 模式适用于长事务拆分场景，比如跨地域的多步骤业务流程，但需要对每个步骤进行详细设计，确保补偿逻辑能正确执行。AT 模式在某些情况下可能无法满足性能要求，而 TCC 和 Saga 则需要额外的开发和维护成本。因此，必须根据业务需求和系统架构进行选择，不能盲目使用。

六 替代方案或进阶技巧

除了 Seata，还有不少分布式事务方案可供选择，比如 Apache ShardingSphere 的分布式事务模块、LCN（Local Transaction Coordination）等。但这些方案各有特点，适用性不同。例如，ShardingSphere 的分布式事务模块在一些项目中表现不错，但其配置较为复杂，需要结合分库分表一起使用。LCN 在某些业务场景中表现良好，但其依赖于数据库的本地事务，无法真正实现跨服务的事务一致性。在实际项目中，我曾遇到一个使用 LCN 的系统，在秒杀场景下因为数据库锁竞争，导致事务频繁超时。后来改用 Seata 的 AT 模式，虽然性能有所下降，但事务稳定性得到了提升。因此，在选择替代方案时，需要权衡其优缺点，不能简单套用。

七 操作本地事务前后需确保一致性

在使用 Seata 的 AT 模式时，每个本地事务的执行必须保证数据的一致性，否则全局事务会失败。例如，在支付流程中，如果数据库的 binlog 记录不完整，或者事务在执行过程中被意外中断，可能导致回滚失败。我见过某个支付服务在执行扣款时，因为数据库连接池配置不合理，导致事务被提前关闭，最终未能正确记录 binlog，事务回滚失败。为了避免这种问题，我通常会在数据库连接池配置中设置合理的超时时间和重试策略，确保本地事务能够顺利完成。此外，在事务提交前，需要确保所有参与服务的本地事务都已执行完毕，否则全局事务可能无法正确回滚。

八 事务分组配置需统一且可扩展

事务分组是 Seata 实现事务协调的关键配置，必须确保所有服务使用相同的事务组名。例如，在使用 Nacos 配置中心时，需要在配置文件中设置 seata.service.vgroupMapping.default_txgroup=lfra-rc。如果某个服务未正确配置事务组名，可能导致全局事务无法正确回滚。我见过一个微服务项目在部署初期未统一事务组名，导致部分服务无法加入全局事务，最终造成数据不一致。后来通过在部署脚本中统一设置事务组名，并在 Nacos 中配置相应的事务分组，问题才得以解决。事务分组的配置需要在部署阶段进行严格审核，避免出现配置错误。

九 配置 registry 和 transaction service 地址

Seata 的事务协调需要 registry 和 transaction service 的地址配置正确，否则服务无法注册和发现。例如，在 Nacos 中，需要设置 seata.registry.nacos.serverAddr=127.0.0.1:8848，并确保 TC 服务已启动。如果 registry 地址配置错误，或者 TC 服务未运行，所有服务的事务都无法协调，导致事务失败。我见过一个项目在使用 Seata 时，因为没配置正确的 TC 地址，所有事务都进入了本地事务，最终导致数据不一致。后来通过在配置中明确指定 TC 的地址，并确保所有服务都能访问，问题才得以解决。配置 registry 和 transaction service 地址是 Seata 部署中的基本步骤，不可省略。

十 事务日志格式和存储路径需统一

Seata 的事务日志存储路径和格式需要统一，否则可能影响事务的回滚和协调。例如，在 AT 模式下，Seata 会将事务日志存储在数据库的 undo_log 表中，因此需要确保这个表的结构和字段与 Seata 的版本兼容。如果数据库版本较旧，或者 undo_log 表的字段不完整，可能导致事务日志无法正确解析，从而影响回滚。我见过一个项目在升级 Seata 版本后，因为 undo_log 表的字段未更新，导致部分事务回滚失败。后来通过手动调整表结构，并重启 Seata 的 TC 服务，问题才得以解决。事务日志的格式和存储路径需要在部署和升级过程中特别注意。

十一 事务超时设置需根据业务合理调整

Seata 的事务超时设置直接影响事务的性能和稳定性，需要根据业务场景合理调整。例如，默认的事务超时时间是 60000 毫秒，但在高并发业务中，这个时间可能不够。我见过一个支付系统在高并发场景下，因为事务超时设置过低，导致部分事务无法完成，最终出现数据不一致。后来通过在配置中设置 seata.tm.commitTimeout=120000 和 seata.tm.rollbackTimeout=120000，将事务超时时间延长，问题才得到缓解。同时，超时时间过长也可能导致资源占用过高，因此需要根据业务的实际需求进行权衡。

十二 本地事务需确保幂等性

在使用 TCC 模式时，本地事务必须确保幂等性，否则可能引发重复提交的问题。例如，在准备阶段，某个服务执行了扣款操作，但在提交阶段由于网络波动，未能成功通知下游服务，导致补偿逻辑未触发。这种情况下，多次提交可能导致数据错误。我见过一个电商项目在 TCC 模式中未实现幂等性，导致用户重复下单后，系统未能正确回滚，最终出现库存异常。后来通过在准备阶段加入订单号校验，并在补偿阶段记录日志，确保每个操作只能执行一次，问题才得以解决。幂等性校验是 TCC 模式中必须考虑的问题，不能忽视。

十三 事务补偿逻辑需明确且可恢复

Saga 模式下的事务补偿逻辑需要明确，并且必须能够正确执行。例如，在一个跨服务的业务流程中，某个步骤失败，需要根据流程顺序进行补偿。我见过一个物流系统在使用 Saga 模式时，因为补偿逻辑未明确，导致部分订单状态无法正确回滚。后来通过在每个步骤中记录操作日志，并在补偿阶段根据日志进行逆向操作，问题才得到解决。此外，补偿逻辑需要确保能够独立执行，不会因为其他事务的失败而影响整体流程。因此，在 Saga 模式中，补偿逻辑的设计和实现必须足够精细，否则可能引发数据不一致。

十四 常见配置项和参数说明

在使用 Seata 时，一些关键配置项和参数需要仔细设置。例如，在 Spring Boot 中，可以通过 application.yml 文件设置 seata.enabled=true，指定事务模式为 seata.tm.type=AT，设置事务分组为 seata.service.vgroupMapping.default_txgroup=lfra-rc。此外，TC 服务的地址需要在 registry 中配置，比如 seata.registry.nacos.serverAddr=127.0.0.1:8848。对于数据库的配置，如使用 MySQL，需要确保 binlog 已开启，并且 undo_log 表的结构和字段与 Seata 兼容。如果某个服务需要使用 TCC 模式，在事务注解中设置 seata.tm.type=TCC，并确保每个操作都带有 prepare、commit、rollback 接口。这些配置项需要在部署前仔细校验，确保事务协调能够正常进行。

十五 服务注册和发现需确保可用性

Seata 的服务注册和发现机制是分布式事务的核心，必须确保其可用性。例如，在使用 Nacos 作为 registry 时，需要确保 Nacos 服务已启动，并且服务实例能够正确注册。如果某个服务实例未能注册，可能导致事务协调失败。我见过一个项目在部署 Seata 时，由于 Nacos 地址配置错误，所有服务的事务都无法协调，导致数据不一致。后来通过在配置文件中正确设置 seata.registry.nacos.serverAddr，并确保服务实例能够访问 Nacos，问题才得以解决。此外，服务注册的健康检查和自动重连机制也需要配置，确保事务协调的稳定性。服务注册和发现是 Seata 运行的基础，必须高度重视。