SpringBoot 集成 Seata 学习笔记

最近因项目需要在网上寻找分布式事务框架，发现阿里开源的Seata组件文档描述概念清晰，而且最吸引我的还是那句，经受住了十余年双十一的考验（视乎阿里开源的组件都有这句话），Seata组件包含XA、TCC、AT、Sage四种模式，其中AT模式支持无侵入集成，用起来也比较简单所以首先学习了AT模式，关于AT模式的理论部分官网写的很好我就不赘述了，本文以实践为主描述了Seata组件的基础和使用。

布式事务用例：

业务用例描述了一个采购过程，消费者在线下单、后台同时扣除账户金额、扣除库存。在开发中我创建了Order微服务模块、Account账户微服务模块、Storage库存微服务模块，通过Feign完成用例的远程调用。

                             

软件环境：

• SpringCloud   Hoxton.RELEASE
• SpringBoot     2.2.0.RELEASE
• Mybatis Plus  3.2.0
• Seata              1.1.0

集成Seata组件

集成Seata的基础工程不是本文描述的重点，我相信能研究分布式事务的同学自己也都能够搭建起基础工程（不想自己搭建的可以下载我的demo工程），因此下面仅重点描述Seata的集成过程。

一、配置Seata Server

1.1. 下载Seata Server

本次开发选择的Seata Server版本是1.1.0，在Github上下载推荐翻墙下载，下载成功后解压到磁盘，进入后会看到如下目录。

• bin   （启动文件目录）
• conf （配置文件目录）
• lib    （依赖jar包目录）

1.2. 创建Seata数据库

安装Seata首先需要创建一个数据库和三张表branch_table、global_table、lock_table，受篇幅所限建表语句就不贴出来了，可用自行下载SQL语句。

1.3. 配置Seata Server

进入conf目录里面包含若干文件其中需要配置仅有registry.conf和file.conf两个文件，其中registry.conf负责配置注册中心和配置中心，如果采用文件配置中心就必须同时配置file.conf这个文件。本文选择Nacos作为注册中心和配置中心（因为支持高可用部署）因此不需要配置file.conf。

第一步，配置registry.conf文件

# 第一部分，注册中心
registry {
  # file 、nacos 、eureka、redis、zk、consul、etcd3、sofa
  type = "nacos"

  nacos {
    serverAddr = "182.92.118.32:8848"
    namespace = ""
    cluster = "default"
  }
......
}
# 第二部分，配置中心
config {
  # file、nacos 、apollo、zk、consul、etcd3
  type = "nacos"

  nacos {
    serverAddr = "182.92.118.32:8848"
    namespace = ""
    group = "SEATA_GROUP"
  }
......
}

第二步，在Nacos配置Seata数据库参数 

store.mode=db
store.db.datasource=dbcp
store.db.dbType=mysql
store.db.driverClassName=com.mysql.jdbc.Driver
store.db.url=jdbc:mysql://47.105.165.30:3306/seata?useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8
store.db.user=seata
store.db.password=123456
store.db.global.table=global_table
store.db.branch.table=branch_table
store.db.lockTable=lock_table

基础配置仅需要将上述内容配置进Nacos即可 

1.3. 启动Seata Server

进入bin目录 windows 环境使用双击seata-server.bat，linux环境使用seata-server.sh启动，因为Seata注册中心和配置中心都使用Nacos因此在启动Seata之前需要先启动Nacos，本文使用linux环境Seata启动执行如下命令。

./seata-server.sh -h 182.92.118.32 -p 8091 -m db -n 1 

•  -h: 注册到注册中心的ip
•  -p: Server rpc 监听端口
•  -m: 全局事务会话信息存储模式，file、db、redis，优先读取启动参数 (Seata-Server 1.3及以上版本支持redis)
•  -n: Server node，多个Server时，需区分各自节点，用于生成不同区间的transactionId，以免冲突

 二、集成Seata Client

基础Seata Client非常简单，在集成之前请自行准备微服务工程，要能实现Feign正常调用。

第一步，在pom中引入Seata依赖

<!-- 阿里开源分布式事务组件 -->
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-alibaba-seata</artifactId>
    <exclusions>
        <exclusion>
            <groupId>io.seata</groupId>
            <artifactId>seata-spring-boot-starter</artifactId>
        </exclusion>
    </exclusions>
</dependency>
<dependency> <!-- 主要想使用 seata 1.1.0 版本 -->
    <groupId>io.seata</groupId>
    <artifactId>seata-spring-boot-starter</artifactId>
    <version>1.1.0</version>
</dependency>

第二步，代理数据源

我使用的是Mybatis Plus所以采用如下集成方式

package cn.microapps.order.config;

import com.alibaba.druid.pool.DruidDataSource;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.sql.DataSource;

@Configuration
public class DataSourceProxyAutoConfig {

    @Bean
    @ConfigurationProperties(prefix = "spring.datasource")
    public DataSource druidDataSource() {
        DruidDataSource druidDataSource = new DruidDataSource();
        return druidDataSource;
    }
}

 第三步，在application.yml配置Seata参数

seata:
  enabled: true
  application-id: ${spring.application.name}  #可自定义
  tx-service-group: my_test_tx_group #事务组名可自定义，但必须与配置中心参数一致
  enable-auto-data-source-proxy: true #数据源自动代理
  config:
    type: nacos
    nacos:
      namespace:
      serverAddr: 182.92.118.32:8848
      group: SEATA_GROUP
      userName: "nacos"
      password: "123456"
  registry:
    type: nacos
    nacos:
      application: seata-server
      server-addr: 182.92.118.32:8848
      namespace:
      userName: "nacos"
      password: "123456"

第四步，在需要开启分布式事务的方法上使用 @GlobalTransactional注解

package cn.microapps.order.service.impl;

import cn.microapps.order.dao.IOrderDao;
import cn.microapps.order.domain.Order;
import cn.microapps.order.feign.IAccountService;
import cn.microapps.order.feign.IStorageService;
import cn.microapps.order.service.IOrderService;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import io.seata.spring.annotation.GlobalTransactional;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

@Service
public class OrderServiceImpl extends ServiceImpl<IOrderDao, Order>
        implements IOrderService {

    @Autowired
    private IAccountService accountService;

    @Autowired
    private IStorageService storageService;

    @Autowired
    private IOrderDao dao;

    @GlobalTransactional
    public String create(Order order) {
        // s1 下单
        dao.insert(order);
        // s3 扣库存
        storageService.deduct("5");
        // s2 扣款
        accountService.deduct(order.getUserId(),order.getMoney()+"");
        return order.getId();
    }
}

第五步，在各业务库中加入undo_log表

CREATE TABLE `undo_log`  (
  `id` bigint(20) NOT NULL AUTO_INCREMENT,
  `branch_id` bigint(20) NOT NULL,
  `xid` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
  `context` varchar(128) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,
  `rollback_info` longblob NOT NULL,
  `log_status` int(11) NOT NULL,
  `log_created` datetime(0) NOT NULL,
  `log_modified` datetime(0) NOT NULL,
  `ext` varchar(100) CHARACTER SET utf8 COLLATE utf8_general_ci DEFAULT NULL,
  PRIMARY KEY (`id`) USING BTREE,
  UNIQUE INDEX `ux_undo_log`(`xid`, `branch_id`) USING BTREE
) ENGINE = InnoDB AUTO_INCREMENT = 22 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Compact;

三、启动工程

分别启动Order、Account、Storage三各微服务工程

 登陆Nacos查看服务启动情况

访问Order订单微服务下单接口启动分布式事务

 有需要集成代码的同学我提供了集成demo工程，可以自行下载研究。