SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

时间:2022-10-24 11:14:43
  • SpringBoot 2.5.5
  • SpringCloud 2020.0.4
  • Alibaba Spring Cloud 2021.1
  • Mybatis Plus 3.4.0
  • Seata 1.4.1需要与服务器部署的Seata版本保持一致
  • 。。。。

Seata介绍



  • TC:Transaction Coordinator事务协调器,管理全局的分支事务的状态,用于全局性事务的提交和回滚
  • TM:Transaction Manager 事务管理器,用户开启、提交或者回滚【全局事务】
  • RM:Resource Manager资源管理器,用于分支事务上的资源管理,向TC注册分支事务,上报分支事务的状态,接收TC的命令来提交或者回滚分支事务
    • 传统XA协议实现2PC方案的RM是在数据库层,RM本质上就是数据库自身
    • Seata的RM是以jar包的形式嵌入在应用程序里面

架构:TC为单独部署的Server服务端,TM和RM为嵌入到应用中的Client客户端

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

 

XID

  • TM请求TC开启一个全局事务,TC会生成一个XID作为该全局事务的编号XID,XID会在微服务的调用链路中传播,保证将多个微服务对的子事务关联在一起

Seata部署安装

下载Seata地址

http://seata.io/zh-cn/blog/download.html

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

  注:我这边下载的是1.4.1,seata部署版本需要与SpringBoot依赖的版本相对应!!!!!!

Seata部署

前期准备

  准备好Nacos、mysql

  注:nacos配置中心数据是持久化到mysql的!!!!

部署&修改配置

修改存储模式DB

  上传至服务器,目录为:/usr/local/software

# 1、创建目录
mkdir -p /usr/local/software

# 2、解压
unzip seata-server-1.4.1.zip

# 3、修改存储模式 DB
cd seata/conf/
vi file.conf

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

 

  注:修改为自己的mysql!!!!

## transaction log store, only used in seata-server
store {
  ## store mode: file、db、redis
  mode = "file"

  ## database store property
  db {
    ## the implement of javax.sql.DataSource, such as DruidDataSource(druid)/BasicDataSource(dbcp)/HikariDataSource(hikari) etc.
    datasource = "druid"
    ## mysql/oracle/postgresql/h2/oceanbase etc.
    dbType = "mysql"
    driverClassName = "com.mysql.cj.jdbc.Driver"
    url = "jdbc:mysql://47.116.143.16:3306/seata?useUnicode=true&characterEncoding=utf-8&useSSL=false&serverTimezone=Asia/Shanghai"
    user = "root"
    password = "root"
    minConn = 5
    maxConn = 100
    globalTable = "global_table"
    branchTable = "branch_table"
    lockTable = "lock_table"
    queryLimit = 100
    maxWait = 5000
  }
}

  将seata需要的3张表导入数据库中,分别是:global_table、branch_table、lock_table

官网地址:http://seata.io/zh-cn/docs/user/quickstart.html

github地址:https://github.com/seata/seata/blob/develop/script/server/db/mysql.sql

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

-- -------------------------------- 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);
seata的mysql脚本

修改Seata 配置中心&注册中心

  修改Seata的配置

# 修改Seata配置
cd /usr/local/software/seata/conf
vi registry.conf

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

  注:修改成自己的nacos信息

registry {
  # file 、nacos 、eureka、redis、zk、consul、etcd3、sofa
  type = "nacos"
  loadBalance = "RandomLoadBalance"
  loadBalanceVirtualNodes = 10

  nacos {
    application = "seata-server"
    serverAddr = "47.116.143.16:8848"
    group = "SEATA_GROUP"
    namespace = ""
    cluster = "default"
    username = "nacos"
    password = "nacos"
  }
}

config {
  # file、nacos 、apollo、zk、consul、etcd3
  type = "nacos"

  nacos {
    serverAddr = "47.116.143.16:8848"
    namespace = ""
    group = "SEATA_GROUP"
    username = "nacos"
    password = "nacos"
  }
}

  因为Seata的配置中心是nacos,需要把Seata的配置,通过脚本推送到nacos中

官网地址:https://seata.io/zh-cn/docs/user/configuration/nacos.html

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

脚本地址:https://github.com/seata/seata/blob/develop/script/config-center/nacos/nacos-config.sh

config.txt地址(可以暂时不修改配置参数,直接到nacos中修改配置):https://github.com/seata/seata/blob/develop/script/config-center/config.txt

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

  将Seata配置参数推送到nacos配置中心

# 1、将github中的nacos-config.sh,传到服务器上,目录为:/usr/local/software/seata/conf
# 我这边使用的是,将脚本文件拷出,在服务创建文件夹,赋予权限
touch nacos-config.sh
chmod +x nacos-config.sh

# 2、将config.txt,放到服务器上,目录为:/usr/local/software/seata

  执行脚本

sh nacos-config.sh -h 47.116.143.16 -p 8848 -g SEATA_GROUP -u nacos -w nacos


-h:nacos主机地址
-p:nacos端口号
-g:nacos分组
-t:nacos命名空间
-u:nacos账号
-w:nacos密码

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

  推送成功,已将Seata配置参数推送到Nacos配置中心

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

  在nacos配置中心里,修改Seata参数,具体修改参考官网如下

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

  具体config.txt里的参数解释https://seata.io/zh-cn/docs/user/configurations.html

新建2个配置需要与微服务中的配置对应上

service.vgroupMapping.${spring.alibaba.seata.tx-service-group}=default




如下
service.vgroupMapping.order_service_group=default
service.vgroupMapping.product_service_group=default

注意:分组为:SEATA_GROUP

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

启动Seata服务

  • ./seata-server.sh启动,默认端口8091(守护进程方式启动 nohup ./seata-server.sh &)

注意:如果seata部署在服务器,微服务在本地启动的话,2个服务不在一个局域网下,因此没法通信,启动Seata时,需要指定ip和端口号

sh seata-server.sh -p 8091 -h 47.116.143.16

Seata AT模式日期序列化问题解决方案

后端服务引入kryo依赖

      <dependency>
            <groupId>com.esotericsoftware</groupId>
            <artifactId>kryo</artifactId>
            <version>4.0.2</version>
        </dependency>
        <dependency>
            <groupId>de.javakaffee</groupId>
            <artifactId>kryo-serializers</artifactId>
            <version>0.42</version>
        </dependency>

修改Seata在nacos配置中心配置

将
client.undo.logSerialization=jackson

修改为
client.undo.logSerialization=kryo

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

微服务整合Seata

前期准备

  在每个微服务所连的库,新建一张表

-- 注意此处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;

聚合工程搭建

  。。。。

项目结构

  • ybchen-common:公共模块
  • ybchen-order-service:订单微服务
  • ybchen-product-service:商品微服务

数据库分表为:order(订单微服务库)、product(商品微服务库)、seata(Seata全局事务涉及的表)、nacos(Nacos配置中心,mysql持久化)

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

Seata依赖

        <dependency>
            <groupId>com.alibaba.cloud</groupId>
            <artifactId>spring-cloud-starter-alibaba-seata</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>io.seata</groupId>
                    <artifactId>seata-spring-boot-starter</artifactId>
                </exclusion>
            </exclusions>
        </dependency>
        <dependency>
            <groupId>io.seata</groupId>
            <artifactId>seata-spring-boot-starter</artifactId>
            <version>1.4.1</version>
        </dependency>

        <!-- seata 自身序列化bug问题-开始 -->
        <dependency>
            <groupId>com.esotericsoftware</groupId>
            <artifactId>kryo</artifactId>
            <version>4.0.2</version>
        </dependency>
        <dependency>
            <groupId>de.javakaffee</groupId>
            <artifactId>kryo-serializers</artifactId>
            <version>0.42</version>
        </dependency>
        <!-- seata 自身序列化bug问题-结束 -->

分布式事务演示

关键代码片段

order-service

    @Autowired
    OrderMapper orderMapper;
    @Autowired
    ProductStockControllerFeign productStockControllerFeign;

    @Override
    //开启分布式事务 Seta AT模式
    @GlobalTransactional
    public ReturnT<String> add() {
        OrderDO orderDO = new OrderDO();
        int outTradeNo = new Random().nextInt(1000);
        orderDO.setOutTradeNo("T" + outTradeNo);
        orderDO.setCreateTime(new Date());
        int rows = orderMapper.insert(orderDO);
        if (rows > 0) {
            //扣减商品库存
            ReturnT<String> reduceReturn = productStockControllerFeign.reduce();
            if (ReturnT.isSuccess(reduceReturn)) {
                log.info("购买成功");
                //TODO 模拟异常方式二
//                int num = 1 / 0;
                return ReturnT.buildSuccess("购买成功");
            }
            // 解决全局拦截器问题,通过接口响应状态码,来判断是否主动抛异常!!!!!!!
            if (reduceReturn.getCode() != 0) {
                log.info("扣减商品库存失败,接口响应:{}", reduceReturn);
                throw new BizException(110, "扣减商品库存失败");
            }
            log.info("扣减商品库存失败");
            return ReturnT.buildError("扣减商品库存失败");
        }
        log.info("购买失败");
        return ReturnT.buildError("购买失败");
    }

product-service

   @Autowired
    ProductStockMapper productStockMapper;


    @Override
    public ReturnT<String> reduceProductStock() {
        ProductStockDO stockDO = new ProductStockDO();
        stockDO.setProductId(10086);
        stockDO.setBuyNum(1);
        stockDO.setCreateTime(new Date());
        int rows = productStockMapper.insert(stockDO);
        //TODO 模拟异常方式一
//        int num = 1 / 0;
        if (rows > 0) {
            log.info("扣减商品库存成功,rows=" + rows);
            return ReturnT.buildSuccess("扣减商品库存成功");
        } else {
            log.info("扣减商品库存失败,rows=" + rows);
            return ReturnT.buildError("扣减失败");
        }
    }

正常情况

  场景描述:product微服务和order微服务均正常,2个微服务的事务全部提交成功,2个库都插入数据成功

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

异常情况一(product微服务异常)

  场景描述:product微服务发生异常,order微服务正常情况,出现异常情况时,需要2个微服务的事务全部回滚,2个库插入的数据都回滚

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

异常情况二(order微服务异常)

  场景描述:order微服务发生异常,product微服务正常,出现异常情况时,需要2个微服务的事务全部回滚,2个库插入的数据都回滚

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

异常情况三(product微服务未启动)

  场景描述:order微服务正常启动,product微服务未启动,需要把order微服务插入的数据回滚

SpringCloud整合分布式事务Seata 1.4.1 支持微服务全局异常拦截

项目源码

https://gitee.com/yenbin_chen/ybchen-seatay