若依微服务架构下Seata 1.5.2与Nacos的分布式事务实战配置与避坑指南

1. 环境准备与组件介绍

在开始配置之前，我们需要先了解几个关键组件。若依（RuoYi）是一个基于Spring Boot的快速开发框架，它提供了微服务版本的支持。Seata则是阿里巴巴开源的分布式事务解决方案，而Nacos作为服务发现和配置中心，能够很好地与Seata配合使用。

我最近在一个电商项目中使用了这套组合，发现确实能有效解决跨服务事务问题。不过在实际配置过程中，遇到了不少版本兼容性和配置细节上的坑，这里都会一一分享给大家。

首先确保你已经安装好以下环境：

• JDK 1.8+
• MySQL 5.7或8.0（注意驱动版本差异）
• Nacos Server 1.4.0+
• 若依微服务项目（建议使用最新版本）

特别提醒：MySQL 5.x和8.x的驱动类不同，这个细节后面会多次提到，很多问题都出在这里。

2. Seata服务端部署

2.1 下载与安装

Seata 1.5.2的下载有两种方式：

1. 直接从官网下载二进制包（seata-server-1.5.2.zip）
2. 通过GitHub Releases页面下载

我推荐第一种方式，更简单直接。下载完成后解压到任意目录，目录结构如下：

seata-server-1.5.2 ├──bin ├──conf ├──lib └──logs

2.2 配置Nacos注册中心

进入conf目录，修改application.yml文件。这里有个关键点：Nacos的namespace配置。如果使用默认空间，可以留空，否则需要填写具体的命名空间ID。

seata: config: type: nacos nacos: server-addr: 127.0.0.1:8848 group: SEATA_GROUP username: nacos password: nacos registry: type: nacos nacos: application: seata-server server-addr: 127.0.0.1:8848 cluster: default

注意：server-addr要根据实际Nacos部署地址修改。我在测试环境就因为这个配置错误，导致服务一直注册不上。

3. Nacos配置中心设置

3.1 创建Seata配置

在Nacos控制台创建seataServer.yml配置，这是Seata的核心配置。内容如下：

service: vgroupMapping: ruoyi-system-group: default store: db: datasource: druid dbType: mysql driverClassName: com.mysql.cj.jdbc.Driver # 8.x使用 url: jdbc:mysql://127.0.0.1:3306/ry-seata?useUnicode=true user: root password: root

这里有个大坑：driverClassName的配置。MySQL 5.x使用com.mysql.jdbc.Driver，而8.x需要使用com.mysql.cj.jdbc.Driver。如果配错会导致启动失败。

3.2 服务模块配置

对于需要使用分布式事务的每个微服务模块，都需要在Nacos中添加对应的vgroupMapping配置。例如：

service.vgroupMapping.ruoyi-order-group=default service.vgroupMapping.ruoyi-payment-group=default

4. 数据库配置

4.1 Seata数据库初始化

创建一个名为ry-seata的数据库，然后执行以下SQL创建三张核心表：

CREATE TABLE IF NOT EXISTS `global_table` ( `xid` VARCHAR(128) NOT NULL, -- 其余字段省略 ) ENGINE = InnoDB DEFAULT CHARSET = utf8mb4; -- branch_table和lock_table结构类似

4.2 业务库undo_log表

每个参与分布式事务的业务数据库都需要创建undo_log表：

CREATE TABLE `undo_log` ( `id` bigint(20) NOT NULL AUTO_INCREMENT, `branch_id` bigint(20) NOT NULL, -- 其余字段省略 PRIMARY KEY (`id`), UNIQUE KEY `ux_undo_log` (`xid`,`branch_id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8;

我在实际项目中遇到过因为没创建这张表导致事务无法回滚的情况，大家一定要注意。

5. 启动与验证

5.1 启动Seata服务

Windows直接运行bin目录下的seata-server.bat，Linux使用：

sh seata-server.sh -h 实际IP -p 8091

注意：-h参数必须指定服务器真实IP，否则注册到Nacos的会是127.0.0.1，其他服务无法访问。

5.2 验证服务注册

启动后可以通过以下方式验证：

1. 查看Nacos服务列表，应该能看到seata-server服务
2. 访问http://IP:7091，使用seata/seata登录控制台
3. 检查日志文件，确认没有错误信息

6. 微服务集成

6.1 添加依赖

在每个微服务模块的pom.xml中添加：

<dependency> <groupId>io.seata</groupId> <artifactId>seata-spring-boot-starter</artifactId> <version>1.5.2</version> </dependency>

6.2 事务注解使用

在主服务方法上添加：

@GlobalTransactional(rollbackFor = Exception.class) public void createOrder() { // 业务逻辑 }

在被调用服务上添加：

@Transactional(propagation = Propagation.REQUIRES_NEW) public void deductStock() { // 库存扣减逻辑 }

特别注意：被调用服务必须使用REQUIRES_NEW传播级别，否则事务不会生效。

7. 常见问题解决

7.1 序列化错误

如果出现类似错误：

Cannot construct instance of `java.time.LocalDateTime`

这是因为Seata默认使用Jackson序列化，而高版本MySQL驱动对日期类型的处理有变化。解决方案：

1. 降低mysql-connector-java版本到8.0.22或以下
2. 或者自定义Jackson的序列化配置

7.2 事务不生效

如果发现事务没有回滚，检查以下几点：

1. undo_log表是否创建
2. @GlobalTransactional是否加在入口方法
3. 被调用服务是否使用REQUIRES_NEW
4. 异常是否被捕获没有抛出

我在实际项目中就遇到过因为异常被catch导致事务没有回滚的情况，排查了很久才发现。

8. 性能优化建议

对于生产环境，建议做以下优化：

1. 调整Seata server的线程池参数
2. 根据业务量调整store.mode（文件或数据库）
3. 合理设置全局事务超时时间
4. 启用Seata的metrics监控

特别是在高并发场景下，默认配置可能会成为性能瓶颈。我们曾经因为没调整线程池参数，导致大量事务超时失败。