目录
Seata与Spring Cloud Alibaba版本对应关系
(2)修改 /conf/application.yml,添加以下内容
(3)新建数据库cloud_seata(名字自定义),sql路径:/script/server/db/mysql.sql,这里用的是mysql
(1)新建seata-server.yml,Data Id:seata-server.yml,Group:SEATA_GROUP
三、Seata Client端配置(springboot项目)
(1)springboot项目pom.xml引入Seata依赖
什么是Seata
Seata(Simple Extensible Autonomous Transaction Architecture)是一款开源的分布式事务解决方案,致力于提供高性能和简单易用的分布式事务服务。Seata 将为用户提供了 AT、TCC、SAGA 和 XA四种事务模式,为用户打造一站式的分布式解决方案,包括事务管理、本地事务协调、分布式事务日志和分布式锁等组件。
Seata通过使用分布式事务日志和分布式锁来保证事务的一致性和可靠性。分布式事务日志记录全局事务的操作日志,并提供了事务的恢复和回滚能力。分布式锁用于保护全局事务在不同参与者之间的并发访问,确保数据的一致性和正确性。
Seata整体架构
一个典型的分布式事务过程分为一ID(全局事务id)+三组件模型。
TC (Transaction Coordinator) - 事务协调者
维护全局和分支事务的状态,驱动全局事务提交或回滚。
TM (Transaction Manager) - 事务管理器
定义全局事务的范围:开始全局事务、提交或回滚全局事务。
RM (Resource Manager) - 资源管理器
管理分支事务处理的资源,与TC交谈以注册分支事务和报告分支事务的状态,并驱动分支事务提交或回滚。
Seata的整体架构如上图,分TC、TM和RM三个角色,TC(Server端)为单独服务端部署,负责维护分布式事务的运行状态,TM和RM(Client端)由业务系统集成,TM是一个分布式事务的发起者和终结者,而RM则负责本地事务的运行并上报。
Seata的事务过程
1、TM向TC申请开启一个全局事务 ,全局事务创建成功并生成一个全局唯一的XID;
2、XID在微服务调用链路的上下文中传播;
3、RM向TC注册分支事务,将其纳入XID对应全局事务的管辖;
4、TM向TC发起针对XID的全局提交或回滚决议;
5、TC调度XID下管辖的全部分支事务完成提交或回滚请求;
Seata与Spring Cloud Alibaba版本对应关系
github下载地址:https://github.com/seata/seata/releases
seata-server-1.5.2.百度网盘下载地址:
链接:https://pan.baidu.com/s/1S5wJVNTI4xAUWraI-AzLhg?pwd=n5pq
提取码:n5pq
一、Seata server端配置
(1)解压下载好的压缩文件
(2)修改 /conf/application.yml,添加以下内容
seata:
# Seata接入Nacos配置中心
config:
type: nacos
nacos:
# nacos地址
server-addr: 127.0.0.1:8848
# 不填为默认
namespace:
# nacos 配置中心的Group名称
group: "SEATA_GROUP"
# nacos 配置中心的Data Id名称
dataId: "seata-server.yml"
# nacos 用户名密码
username: "nacos"
password: "nacos"
# Seata接入Nacos服务注册中心
registry:
type: nacos
nacos:
# 注册到nacos 的服务名称
application: seata-server
# nacos地址
server-addr: 127.0.0.1:8848
# nacos 配置中心的Group名称
group: "SEATA_GROUP"
# 不填为默认
namespace:
cluster: default
# nacos 用户名密码
username: "nacos"
password: "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:
# Seata接入Nacos配置中心
config:
type: nacos
nacos:
# nacos地址
server-addr: 127.0.0.1:8848
# 不填为默认
namespace:
# nacos 配置中心的Group名称
group: "SEATA_GROUP"
# nacos 配置中心的Data Id名称
dataId: "seata-server.yml"
# nacos 用户名密码
username: "nacos"
password: "nacos"
# Seata接入Nacos服务注册中心
registry:
type: nacos
nacos:
# 注册到nacos 的服务名称
application: seata-server
# nacos地址
server-addr: 127.0.0.1:8848
# nacos 配置中心的Group名称
group: "SEATA_GROUP"
# 不填为默认
namespace:
cluster: default
# nacos 用户名密码
username: "nacos"
password: "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
(3)新建数据库cloud_seata(名字自定义),sql路径:/script/server/db/mysql.sql,这里用的是mysql
-- -------------------------------- 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_and_branch_id` (`xid` , `branch_id`)
) 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);
二、nacos配置管理中新建Seata配置
(1)新建seata-server.yml,Data Id:seata-server.yml,Group:SEATA_GROUP
service:
vgroupMapping:
# my-cloud-group为自定义名称,记住之后要用到
my-cloud-group: default
default:
# 服务端ip端口
grouplist: 127.0.0.1:8091
store:
# 数据库连接
db:
datasource: druid
dbType: mysql
driverClassName: com.mysql.cj.jdbc.Driver
url: jdbc:mysql://127.0.0.1:3306/cloud_seata?useUnicode=true&characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useSSL=false
user: root
password: root
globalTable: global_table
lockTable: lock_table
branchTable: branch_table
maxConn: 30
maxWait: 5000
minConn: 5
queryLimit: 100
mode: db
三、Seata Client端配置(springboot项目)
(1)springboot项目pom.xml引入Seata依赖
<!-- SpringBoot seata -->
<dependency>
<groupId>io.seata</groupId>
<artifactId>seata-spring-boot-starter</artifactId>
</dependency>
<dependency>
<groupId>com.alibaba.cloud</groupId>
<artifactId>spring-cloud-starter-alibaba-seata</artifactId>
<exclusions>
<exclusion>
<groupId>io.seata</groupId>
<artifactId>seata-all</artifactId>
</exclusion>
<exclusion>
<groupId>io.seata</groupId>
<artifactId>seata-spring-boot-starter</artifactId>
</exclusion>
</exclusions>
</dependency>
(2)springboot项目数据库添加undo_log表
undo_log表的作用是记录分布式事务的回滚操作。当一个分布式事务提交时,Seata会将事务的操作记录到undo_log表中,包括需要执行的回滚SQL语句等。如果事务提交成功,则undo_log表中的记录会被标记为已完成(DONE);如果事务提交失败,则会标记为回滚失败(FAILED),以便后续进行回滚操作。
CREATE TABLE `undo_log` (
`branch_id` bigint NOT NULL COMMENT 'branch transaction id',
`xid` varchar(128) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL COMMENT 'global transaction id',
`context` varchar(128) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL COMMENT 'undo_log context,such as serialization',
`rollback_info` longblob NOT NULL COMMENT 'rollback info',
`log_status` int NOT NULL COMMENT '0:normal status,1:defense status',
`log_created` datetime(6) NOT NULL COMMENT 'create datetime',
`log_modified` datetime(6) NOT NULL COMMENT 'modify datetime',
UNIQUE KEY `ux_undo_log` (`xid`,`branch_id`) USING BTREE
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb3 ROW_FORMAT=DYNAMIC COMMENT='AT transaction mode undo table';
(3)springboot项目配置文件添加以下内容
# seata
seata:
enabled: true
application-id: ${spring.application.name}
# my-cloud-group为之前在seata-server.yml中定义的service.vgroupMapping.my-cloud-group
tx-service-group: my-cloud-group
service:
vgroup-mapping:
# my-cloud-group为之前在seata-server.yml中定义的service.vgroupMapping.my-cloud-group
my-cloud-group: default
default:
# seata的ip 端口
grouplist: 127.0.0.1:8091
config:
# 连接nacos配置中心
type: nacos
nacos:
server-addr: 127.0.0.1:8848
group: SEATA_GROUP
namespace:
username: nacos
password: nacos
data-id: seata-server.yml
(4)通过注解开启全局事务
@GlobalTransactional(rollbackFor = Exception.class)
四、解决因全局异常处理导致的全局事务失效问题
import io.seata.common.util.StringUtils;
import io.seata.core.context.RootContext;
import io.seata.core.exception.TransactionException;
import io.seata.tm.api.GlobalTransactionContext;
import org.aspectj.lang.JoinPoint;
import org.aspectj.lang.annotation.AfterThrowing;
import org.aspectj.lang.annotation.Aspect;
import org.aspectj.lang.annotation.Before;
import org.aspectj.lang.annotation.Pointcut;
import org.aspectj.lang.reflect.MethodSignature;
import org.springframework.stereotype.Component;
import java.lang.reflect.Method;
@Aspect
@Component
public class SeataAspect {
@Pointcut("within(com.cloud..*.controller..*)")
public void controllerAspect() {
}
@Before("controllerAspect()")
public void before(JoinPoint joinPoint) {
MethodSignature signature = (MethodSignature) joinPoint.getSignature();
Method method = signature.getMethod();
if (StringUtils.isNotEmpty(RootContext.getXID())) {
System.out.printf("拦截到需要分布式事务的方法:{},分布式全局事务XID:{}", method.getName(), RootContext.getXID());
}
}
/**
* 用于解决全局异常处理导致的全局事务失效问题
*/
@AfterThrowing(throwing = "e", pointcut = "controllerAspect()")
public void doRecoveryActions(Throwable e) throws TransactionException {
if (StringUtils.isNotEmpty(RootContext.getXID())) {
System.out.printf("分布式全局事务XID:{}", RootContext.getXID());
GlobalTransactionContext.reload(RootContext.getXID()).rollback();
}
}
}