微服务项目中使用seata，以nacos作为配置中心，很详细_seata nacos配置

一、环境

nacos2.2.1
若依微服务版3.6.2
seata1.6.1

二、下载安装seata

已经下载好的朋友可以跳过这个步骤。这里下载的是seata1.6.1这个版本。

1、进入seata官网

地址：

https://seata.io/zh-cn/index.html

2、进入下载

3、点击下载地址

下载地址：

https://github.com/seata/seata

在github上下载会比较慢，可以在若依这个网盘链接中下载：

https://pan.baidu.com/s/1E9J52g6uW_VFWY34fHL6zA 提取码: vneh

三、切换nacos为配置中心

下载好seata后，不是像redis那样双击启动，不报错就完事了，要想切换为nacos为配置中心，在微服务项目中生效，还要做一些配置。

下载的压缩包为“seata-server-1.6.1.zip”，解压之后是名为“seata”的文件夹。

1、配置yml文件

打开“seata-conf”目录

打开“application.yml”文件，同时打开“application.example.yml”文件作为参考

因为我们要切换为nacos为配置中心，只要看“application.example.yml”文件的“seata-config-nacos”和“seata-registry-nacos”就行了

最后配置完之后是这样的：

完整的是这样的

server:
  port: 7091

spring:
  application:
    name: seata-server

logging:
  config: classpath:logback-spring.xml
  file:
    path: ${user.home}/logs/seata
  extend:
    logstash-appender:
      destination: 127.0.0.1:4560
    kafka-appender:
      bootstrap-servers: 127.0.0.1:9092
      topic: logback_to_logstash

console:
  user:
    username: seata
    password: seata

seata:
  config:
    # support: nacos, consul, apollo, zk, etcd3
    type: nacos
    nacos:
      server-addr: 127.0.0.1:8848  # nacos地址
      group: SEATA_GROUP  # 配置文件的分组
      username: nacos  # nacos用户名
      password: nacos  # nacos密码
      # 这是默认值
      data-id: seata.properties  # 配置文件的data id也就是配置文件名加后缀
  registry:
    # support: nacos, eureka, redis, zk, consul, etcd3, sofa
    type: nacos
    nacos:
      application: seata-server   #seata启动后在nacos的服务名
      server-addr: 127.0.0.1:8848  # nacos地址
      group: SEATA_GROUP  # 配置文件的分组
      cluster: default  # 这个歌参数在每个微服务seata时会用到
      username: nacos  # nacos用户名
      password: nacos  # nacos密码
  store:
    # support: file 、 db 、 redis
    mode: file
#  server:
#    service-port: 8091 #If not configured, the default is '${server.port} + 1000'
  security:
    secretKey: SeataSecretKey0c382ef121d778043159209298fd40bf3850a017
    tokenValidityInMilliseconds: 1800000
    ignore:
      urls: /,/**/*.css,/**/*.js,/**/*.html,/**/*.map,/**/*.svg,/**/*.png,/**/*.ico,/console-fe/public/**,/api/v1/auth/login

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

2、在nacos中增加seata配置

（1）、新建配置

然后填入如下数据

注意：

Data ID是“application.yml”中的“seata-config-nacos-data-id”；
Group是“application.yml”中的“seata-config-nacos-group”；
配置内容在seata目录中“seata-script-config-center”中的“config.txt”文件中。

如图所示

配置内容目录：

找到mysql相关的配置，只要这部分就可以了

这是具体的配置内容：

store.db.datasource=druid
store.db.dbType=mysql
store.db.driverClassName=com.mysql.jdbc.Driver
store.db.url=jdbc:mysql://127.0.0.1:3306/seata?useUnicode=true&rewriteBatchedStatements=true
store.db.user=username
store.db.password=password
store.db.minConn=5
store.db.maxConn=30
store.db.globalTable=global_table
store.db.branchTable=branch_table
store.db.distributedLockTable=distributed_lock
store.db.queryLimit=100
store.db.lockTable=lock_table
store.db.maxWait=5000
1
2
3
4
5
6
7
8
9
10
11
12
13
14

记得把数据库，用户名和密码改为自己的。

我是整合到微服务版的若依当中，会增加一些内容，我的是这样的：

# 下面两行是在原来配置的基础上新增的
service.vgroupMapping.ruoyi-system-group=default
store.mode=db
store.db.datasource=druid
store.db.dbType=mysql
store.db.driverClassName=com.mysql.cj.jdbc.Driver
store.db.url=jdbc:mysql://127.0.0.1:3306/cj-seata?useUnicode=true
store.db.user=root
store.db.password=123456
store.db.minConn=5
store.db.maxConn=30
store.db.globalTable=global_table
store.db.branchTable=branch_table
store.db.queryLimit=100
store.db.lockTable=lock_table
store.db.maxWait=5000
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

（2）、seata数据库相关

数据库就是上面配置中的数据库，是跟seata相关的，下载的seata中提供了对应的sql。

sql对应目录：

先打开mysql，新建数据库，这是我的：

CREATE DATABASE `cj-seata`;
1

然后再打开sql文件，拿到对应的sql语句执行。官网上也说seata模式需要“undo_log”表，sql文件中没有，但官网提供了，也一并加上。

最后，除建立数据库外，所有的执行sql如下：

-- -------------------------------- The script used when storeMode is 'db' --------------------------------
-- the table to store GlobalSession data
CREATE TABLE IF NOT EXISTS `global_table`
(
    `xid`                       VARCHAR(128) NOT NULL,
    `transaction_id`            BIGINT,
    `status`                    TINYINT      NOT NULL,
    `application_id`            VARCHAR(32),
    `transaction_service_group` VARCHAR(32),
    `transaction_name`          VARCHAR(128),
    `timeout`                   INT,
    `begin_time`                BIGINT,
    `application_data`          VARCHAR(2000),
    `gmt_create`                DATETIME,
    `gmt_modified`              DATETIME,
    PRIMARY KEY (`xid`),
    KEY `idx_status_gmt_modified` (`status` , `gmt_modified`),
    KEY `idx_transaction_id` (`transaction_id`)
) ENGINE = InnoDB
  DEFAULT CHARSET = utf8mb4;

-- the table to store BranchSession data
CREATE TABLE IF NOT EXISTS `branch_table`
(
    `branch_id`         BIGINT       NOT NULL,
    `xid`               VARCHAR(128) NOT NULL,
    `transaction_id`    BIGINT,
    `resource_group_id` VARCHAR(32),
    `resource_id`       VARCHAR(256),
    `branch_type`       VARCHAR(8),
    `status`            TINYINT,
    `client_id`         VARCHAR(64),
    `application_data`  VARCHAR(2000),
    `gmt_create`        DATETIME(6),
    `gmt_modified`      DATETIME(6),
    PRIMARY KEY (`branch_id`),
    KEY `idx_xid` (`xid`)
) ENGINE = InnoDB
  DEFAULT CHARSET = utf8mb4;

-- the table to store lock data
CREATE TABLE IF NOT EXISTS `lock_table`
(
    `row_key`        VARCHAR(128) NOT NULL,
    `xid`            VARCHAR(128),
    `transaction_id` BIGINT,
    `branch_id`      BIGINT       NOT NULL,
    `resource_id`    VARCHAR(256),
    `table_name`     VARCHAR(32),
    `pk`             VARCHAR(36),
    `status`         TINYINT      NOT NULL DEFAULT '0' COMMENT '0:locked ,1:rollbacking',
    `gmt_create`     DATETIME,
    `gmt_modified`   DATETIME,
    PRIMARY KEY (`row_key`),
    KEY `idx_status` (`status`),
    KEY `idx_branch_id` (`branch_id`),
    KEY `idx_xid` (`xid`)
) ENGINE = InnoDB
  DEFAULT CHARSET = utf8mb4;

CREATE TABLE IF NOT EXISTS `distributed_lock`
(
    `lock_key`       CHAR(20) NOT NULL,
    `lock_value`     VARCHAR(20) NOT NULL,
    `expire`         BIGINT,
    primary key (`lock_key`)
) ENGINE = InnoDB
  DEFAULT CHARSET = utf8mb4;

INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('AsyncCommitting', ' ', 0);
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('RetryCommitting', ' ', 0);
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('RetryRollbacking', ' ', 0);
INSERT INTO `distributed_lock` (lock_key, lock_value, expire) VALUES ('TxTimeoutCheck', ' ', 0);

-- 注意此处0.3.0+ 增加唯一索引 ux_undo_log
CREATE TABLE `undo_log` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `branch_id` bigint(20) NOT NULL,
  `xid` varchar(100) NOT NULL,
  `context` varchar(128) NOT NULL,
  `rollback_info` longblob NOT NULL,
  `log_status` int(11) NOT NULL,
  `log_created` datetime NOT NULL,
  `log_modified` datetime NOT NULL,
  `ext` varchar(100) DEFAULT NULL,
  PRIMARY KEY (`id`),
  UNIQUE KEY `ux_undo_log` (`xid`,`branch_id`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8;

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89

我的是这样的：

注意，业务数据库也要增加“undo_log”表，一定不要忘了！！！

3、启动seata

进入“seata-bin”目录，双击“seata-server.bat”，会弹出个黑窗口。

然后可以在nacos中看到对应的服务

四、在微服务中使用seata，以微服务版若依为例

1、查看若依相关的手册

地址如下：

http://doc.ruoyi.vip/ruoyi-cloud/cloud/seata.html#%E5%9F%BA%E6%9C%AC%E4%BB%8B%E7%BB%8D

这里以系统模块“ruoyi-system”为例。

先在pom文件中增加seata相关依赖：

<!--分布式事务-->
<dependency>
    <groupId>com.ruoyi</groupId>
    <artifactId>ruoyi-common-seata</artifactId>
</dependency>
1
2
3
4
5

在对应的yml文件中，添加seata相关配置，观察发现在原yml的基础上添加如下配置：

# spring配置
spring: 
  datasource:
    dynamic:
      # 开启seata代理
      seata: true
      
# seata配置
seata:
  enabled: true
  # Seata 应用编号，默认为 ${spring.application.name}
  application-id: ${spring.application.name}
  # Seata 事务组编号，用于 TC 集群名
  tx-service-group: ${spring.application.name}-group
  # 关闭自动代理
  enable-auto-data-source-proxy: false
  # 服务配置项
  service:
    # 虚拟组和分组的映射
    vgroup-mapping:
      ruoyi-system-group: default
    # 分组和 Seata 服务的映射
    grouplist:
      default: 127.0.0.1:8091
  config:
    type: file
  registry:
    type: file

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

我完整的“ruoyi-system-dev.yml”是这样子的：

# spring配置
spring:
  redis:
    host: localhost
    port: 6379
    password:
  datasource:
    druid:
      stat-view-servlet:
        enabled: true
        loginUsername: admin
        loginPassword: 123456
    dynamic:
      druid:
        initial-size: 5
        min-idle: 5
        maxActive: 20
        maxWait: 60000
        timeBetweenEvictionRunsMillis: 60000
        minEvictableIdleTimeMillis: 300000
        validationQuery: SELECT 1 FROM DUAL
        testWhileIdle: true
        testOnBorrow: false
        testOnReturn: false
        poolPreparedStatements: true
        maxPoolPreparedStatementPerConnectionSize: 20
        filters: stat,slf4j
        connectionProperties: druid.stat.mergeSql\=true;druid.stat.slowSqlMillis\=5000
      datasource:
          # 主库数据源
          master:
            driver-class-name: com.mysql.cj.jdbc.Driver
            url: jdbc:mysql://localhost:3306/cj-cloud?useUnicode=true&characterEncoding=utf8&zeroDateTimeBehavior=convertToNull&useSSL=true&serverTimezone=GMT%2B8
            username: root
            password: 123456
          # 从库数据源
          # slave:
            # username: 
            # password: 
            # url: 
            # driver-class-name: 
      # 开启seata代理
      seata: true

# seata配置
seata:
  enabled: true
  # Seata 应用编号，默认为 ${spring.application.name}
  application-id: ${spring.application.name}
  # Seata 事务组编号，用于 TC 集群名
  tx-service-group: ${spring.application.name}-group
  # 关闭自动代理
  enable-auto-data-source-proxy: false
  # 服务配置项
  service:
    # 虚拟组和分组的映射
    vgroup-mapping:
      ruoyi-system-group: default
    # 分组和 Seata 服务的映射
    # grouplist:  # 仅注册中心为file时使用
      # default: 127.0.0.1:8091
  config:
    type: nacos
    nacos:
      serverAddr: 127.0.0.1:8848
      group: SEATA_GROUP
      namespace:
  registry:
    type: nacos
    nacos:
      server-addr: 127.0.0.1:8848
      namespace:
      #可选
      username: nacos
      #可选
      password: nacos
      #可选
      application: seata-server
      #默认值和 config 的 SEATA_GROUP 不一样 
      group: SEATA_GROUP
      # 可选  默认
      # cluster: default 

# mybatis配置
mybatis:
    # 搜索指定包别名
    typeAliasesPackage: com.ruoyi.system
    # 配置mapper的扫描，找到所有的mapper.xml映射文件
    mapperLocations: classpath:mapper/**/*.xml
    configuration:
      log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

# swagger配置
swagger:
  title: 系统模块接口文档
  license: Powered By ruoyi
  licenseUrl: https://ruoyi.vip
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97

2、重启系统模块

启动时报错：

can not get cluster name in registry config ‘service.vgroupMapping.default_tx_group’, please make sure registry config correct

这是因为“service.vgroupMapping.default_tx_group”为事务组名称，这里的值需要和TC配置（也就是yml文件）的“seata.tx-service-group”值保持一致。

其中：

1、“tx-service-group”为自定义名称，可以随便取，这里使用若依提供的名称。
2、事务组的命名不要用下划线“”，可以用“-”，因为在seata的高版本中使用“”将导致service not to be found。

解决办法：

在nacos中增加一个Data ID为“service.vgroupMapping.default_tx_group”的配置

前面的配置文件中规定，“group”为“SEATA_GROUP”；配置内容先随便写，这里写一个“test”。

再次重启，还是报错，报错如下：

no available service found in cluster ‘default’, please make sure registry config correct and keep your seata server running

这是因为seata客户端和服务端配置不一致导致的。

解决办法：

对照着seata的yml文件，把“service.vgroupMapping.default_tx_group”的配置内容修改过来，再次重启问题就解决了。

前面已经知道在seata的yml定义的“seata-registry-nacos-cluster”值为“default”

将“service.vgroupMapping.default_tx_group”的配置内容修改为“default”

再次重启

成功！

再看seata服务端：

可以看到已经在seata服务端注册成功！

五、在使用seata过程中的一些坑（可以不看）

我的业务是这样的，要删除医生数据的同时删除对应的账号和关联角色，其中删除医生数据是主业务，删除医生账号和角色是被调用服务。

1、坑一

这个坑很多人应该遇到过，就是调用服务时，主业务正常回滚，被调用服务不会回滚。我这里就是删除医生数据报错时，医生数据相关业务正常回滚，删除账号和角色回滚失败。

这是我的主业务，在project服务中，删除医生信息业务：

方法的最后抛出异常，测试回滚。

删除账号和角色的逻辑是若依自带的，在测试的过程被调用，这是删除账号的：

这是删除角色的：

问题：

在删除医生数据时出现错误，对应的医生数据业务会回滚，删除账号和角色不会回滚，并且seata数据库的“global_table”表和“undo_log”表没有新增数据。

解决办法一：

网上说可能是主业务和子业务XID不一致的问题。

查看控制台，在删除医生数据时出现的XID

删除账号和角色对应的XID

观察发现所有业务的XID是一样的。

查看seata控制台，看看有没有回滚成功

打印回滚成功。显然我的不是XID的问题。

解决办法二：

参考了这位老哥的博客

“undo_log”表自增主键的问题，去掉自增主键。

于是我去掉业务数据库和seata的数据库“undo_log”表的自增主键，再次测试。

删除医生数据的XID

“undo_log”表还是没有数据，但是“global_table”表新增了数据，并且XID是对应删除医生数据的XID，但子业务还是没有回滚。

但看那位老哥的评论区都说解决了，不应该到我这就不行了。

又从头到尾对比了一下yml文件中的seata配置，发现我没有加上下面的配置：

加上之后重启seata和微服务，然后再次测试，报了一个这样的错：

Field 'id' doesn't have a default value\n; java.sql.SQLException: Field 'id' doesn't have a default value; nested exception is java.sql.SQLException: java.sql.SQLException: Field 'id' doesn't have a default value",
1

前面确实把“undo_log”表的自增主键去掉了，回去勾选上。再次测试：

主业务回滚

被调用服务回滚

查看数据库，这次不仅医生数据回滚，对应的账号和角色也回滚了。

这也证明了seata在处理事务的过程中确实有往“undo_log”表增加数据，但为什么执行完之后看不到“undo_log”表中的数据呢？

控制台中出现的这个：

xid 192.168.1.12:8091:6278425795117363335 branch 6278425795117363338, undo_log deleted with GlobalFinished
1

这是告诉我们在回滚事务完成后undo_log日志被删除掉了。undo_log表是用来回滚事务的表，如果程序执行完再看，一般就是空表，所以要想查看表中的数据，就要在操作完数据库和出现异常的中间打断点查看。

2、坑二

使用seata测试全局事务回滚时报错：

org.springframework.transaction.TransactionSystemException: JDBC commit failed; nested exception is java.sql.SQLException: io.seata.core.exception.RmTransactionException: Response[ TransactionException[branch register request failed. xid=192.168.1.12:8091:5044458163521647146, msg=Data truncation: Data too long for column 'row_key' at row 1] ]
1

JDBC提交失败，使用Mybatis后已经很久没有看到JDBC相关的错误了。

异常的关键信息在这里，说 row_key 字段的数据太长，但我很确定我的数据表中没有这个字段，会不会是 seata 数据表的问题？

看了一下 seata 的控制台，可能真的是 seata 数据表的问题，找找数据表中有没有这个字段。

看了一下，只有这张表才有 row_key 字段，原来的长度是128，我将它改为256，再次测试。

回滚成功

终于整出来，感觉seata对小白真的太不友好了。