Seata分布式事务中分支注册失败问题分析与解决方案

问题背景

在使用Seata分布式事务框架时，开发人员可能会遇到分支注册失败的问题。本文以一个典型场景为例：在使用@GlobalTransactional注解时，出现"branch register failed"错误，错误信息显示"Duplicate entry for key 'lock_table.PRIMARY'"。

错误现象

当执行包含@GlobalTransactional注解的方法时，系统抛出异常：

io.seata.core.exception.RmTransactionException: branch register failed, xid: 192.168.10.196:8091:9566836486799687, errMsg: TransactionException[branch register request failed. xid=192.168.10.196:8091:9566836486799687, msg=Duplicate entry 'jdbc:mysql://192.168.10.195:3306/cloud_logistics_service^^^logis' for key 'lock_table.PRIMARY']

技术环境

• Seata版本：1.7.1
• 动态数据源组件：dynamic-datasource-spring-boot-starter 3.5.2
• MyBatis-Plus版本：3.3.2
• 数据库：MySQL

问题分析

1. 根本原因

该问题的核心在于Seata的锁表(lock_table)中出现了重复的主键条目。当Seata尝试注册分支事务时，会向lock_table表中插入记录，而由于某种原因，这些记录的主键发生了冲突。

2. 具体原因

在多数据源环境下，dynamic-datasource-spring-boot-starter 3.5.2版本与Seata的集成存在兼容性问题。当使用该版本时，Seata无法正确处理数据源切换，导致在注册分支事务时生成重复的锁记录。

3. 技术细节

Seata在AT模式下工作时，会为每个分支事务在lock_table中记录以下信息：

• 资源ID(resource_id)：通常是JDBC连接字符串
• 表名(table_name)
• 行键(row_key)

当这些信息的组合出现重复时，就会导致主键冲突，进而引发分支注册失败。

解决方案

1. 版本降级

将dynamic-datasource-spring-boot-starter降级到2.5.4版本可以解决此问题。这是因为2.5.4版本与Seata的集成更为稳定。

2. 配置调整

确保正确配置Seata与动态数据源的集成：

spring.cloud.alibaba.seata.enableAutoDataSourceProxy=false
spring.cloud.alibaba.seata.client.support.spring.datasource-autoproxy=false

3. 排除自动配置

在Spring Boot启动类中排除数据源自动配置：

@SpringBootApplication(exclude = {DruidDataSourceAutoConfigure.class, DataSourceAutoConfiguration.class})

最佳实践

1. 版本选择：在使用Seata时，应仔细选择与之兼容的动态数据源组件版本。

2. 配置验证：确保所有与Seata相关的配置项都已正确设置，特别是数据源代理相关的配置。

3. 日志监控：密切关注Seata的日志输出，特别是分支注册阶段的日志，可以及早发现问题。

4. 锁表维护：定期检查Seata的lock_table表，确保没有异常数据积累。

总结

Seata分布式事务框架在多数据源环境下的集成需要特别注意组件版本兼容性和配置正确性。当遇到分支注册失败问题时，首先应检查lock_table中的主键冲突情况，然后考虑调整动态数据源组件的版本或相关配置。通过合理的版本选择和配置，可以确保Seata在多数据源环境下稳定工作。