进阶指南

本章节展示 Seata 相关配置和事务模式。

参数配置

公共部分

配置项	key	默认值	说明
socket通信方式	transport.type	TCP	TCP、UNIX_DOMAIN_SOCKET
socket通道类型	transport.server		NIO、NATIVE(根据操作系统类型和socket通信方式选择KQueue或Epoll，注意Windows只支持NIO，选择这种方式会抛出异常）
TM批量发送请求消息开关	transport.enableTmClientBatchSendRequest	false
RM批量发送请求消息开关	transport.enableRmClientBatchSendRequest	true
TC批量发送回复消息开关	transport.enableTcServerBatchSendResponse	false
RM发送请求超时时间	transport.rpcRmRequestTimeout	30秒
TM发送请求超时时间	transport.rpcTmRequestTimeout	30秒
TC发送请求超时时间	transport.rpcTcRequestTimeout	30秒
Netty通信模型Boss group线程数	transport.threadFactory.bossThreadSize	1
Netty通信模型Worker group线程数	transport.threadFactory.workerThreadSize	Default	可配置线程数或选择特定线程工作模式下的线程数，线程的默认工作模式有4种:Auto(2CPU核数 + 1)、Pin(CPU核数，适用于计算密集型任务)、BusyPin(CPU核数 + 1，适用于计算密集型且内存比较有限的场景）、Default(2CPU核数，适用于IO密集型任务）
服务端Netty线程池关闭前等待服务下线时间	transport.shutdown.wait	3秒
client和server通信编解码方式	transport.serialization	seata	seata(ByteBuf)、protobuf、kryo、hession、fst
client和server通信数据压缩方式	transport.compressor	none	none、gzip、zip、sevenz、bzip2、lz4、deflater、zstd
client和server通信心跳检测开关	transport.heartbeat	true
注册中心类型	registry.type	file	支持file 、nacos 、redis、eureka、zk、consul、etcd3、sofa、custom
配置中心类型	config.type	file	支持file、nacos 、apollo、zk、consul、etcd3、springcloud、custom

服务端

配置项	key	默认值	说明
undo保留天数	server.undo.logSaveDays	7天
undo清理线程间隔时间	server.undo.logDeletePeriod	86400000毫秒
二阶段提交重试超时时长	server.maxCommitRetryTimeout	-1	单位ms,s,m,h,d,对应毫秒,秒,分,小时,天,默认毫秒。默认值-1表示无限重试。
二阶段回滚重试超时时长	server.maxRollbackRetryTimeout
二阶段提交未完成状态全局事务重试提交线程间隔时间	server.recovery.committingRetryPeriod	1000，单位毫秒
二阶段异步提交状态重试提交线程间隔时间	server.recovery.asynCommittingRetryPeriod	1000，单位毫秒
二阶段回滚状态重试回滚线程间隔时间	server.recovery.rollbackingRetryPeriod	1000，单位毫秒
超时状态检测重试线程间隔时间	server.recovery.timeoutRetryPeriod	1000，单位毫秒	检测出超时将全局事务置入回滚会话管理器
二阶段回滚超时后是否释放锁	server.rollbackRetryTimeoutUnlockEnable	false
Sever端事务管理全局锁超时时间	server.distributedLockExpireTime	10000，单位毫秒
防止XA分支事务悬挂的重试超时时间	server.server.xaerNotaRetryTimeout	60000，单位毫秒
分支事务Session异步删除线程池队列大小	server.session.branchAsyncQueueSize	5000
分支事务Session异步删除开关	server.session.enableBranchAsyncRemove	false
对于批量请求消息的并行处理开关	server.enableParallelRequestHandle	false
事务会话信息存储方式	store.mode		file本地文件(不支持HA)，db数据库，redis(支持HA)
事务锁信息存储方式	store.lock.mode		file本地文件(不支持HA)，db数据库，redis(支持HA)；配置为空时，取store.mode配置项值
事务回话信息存储方式	store.session.mode	file本地文件(不支持HA)，db数据库，redis(支持HA)；配置为空时，取store.mode配置项值
db或redis存储密码解密公钥	store.publicKey
file模式文件存储文件夹名	store.file.dir	sessionStore
file模式文件存储分支session最大字节数	store.file.maxBranchSessionSize	16384(16kb),单位byte
file模式文件存储全局session最大字节数	store.file.maxGlobalSessionSize	512b，单位byte
file模式文件存储buffer最大缓存大小	store.file.fileWriteBufferCacheSize	16384(16kb)，单位byte	写入session等数据量大于该值时会抛出异常
file模式文件存储刷盘策略	store.file.flushDiskMode	async	可选sync
file模式文件存储Server节点重启后从备份文件中恢复的session或lock key上限个数	store.file.sessionReloadReadSize	100
db模式数据源类型	store.db.datasource		dbcp、druid、hikari；无默认值，store.mode=db时必须指定
db模式数据库类型	store.db.dbType		mysql、oracle、db2、sqlserver、sybaee、h2、sqlite、access、postgresql、oceanbase；无默认值，store.mode=db时必须指定
db模式数据库驱动	store.db.driverClassName		store.mode=db时必须指定
db模式数据库url	store.db.url		store.mode=db时必须指定，在使用mysql作为数据源时，建议在连接参数中加上rewriteBatchedStatements=true
db模式数据库账户	store.db.user		store.mode=db时必须指定
db模式数据库账户密码	store.db.password		store.mode=db时必须指定
db模式数据库初始连接数	store.db.minConn	1
db模式数据库最大连接数	store.db.maxConn	20
db模式获取连接时最大等待时间	store.db.maxWait	5000，单位毫秒
db模式全局事务表名	store.db.globalTable	global_table

NOTE：更多详见：server 端配置项参考。

客户端

配置项	key	默认值	说明
是否开启spring-boot自动装配	seata.enabled	true
是否开启数据源自动代理	seata.enableAutoDataSourceProxy=true	ture
是否使用JDK代理作为数据源自动代理的实现方式	seata.useJdkProxy=false	false	采用CGLIB作为数据源自动代理的实现方式
客户端事务消息请求是否批量合并发送	transport.enableClientBatchSendRequest	true	false单条发送
日志异常输出概率	client.log.exceptionRate	100	目前用于undo回滚失败时异常堆栈输出，百分之一的概率输出，回滚失败基本是脏数据，无需输出堆栈占用硬盘空间
事务群组	service.vgroupMapping.my_test_tx_group		my_test_tx_group为分组，配置项值为TC集群名
TC服务列表	service.default.grouplist		仅注册中心为file时使用
全局事务开关	service.disableGlobalTransaction	false	false为开启，true为关闭
降级开关	client.tm.degradeCheck	默认false	业务侧根据连续错误数自动降级不走seata事务
升降级达标阈值	client.tm.degradeCheckAllowTimes	默认10
服务自检周期	client.tm.degradeCheckPeriod	2000,单位ms	每2秒进行一次服务自检,来决定
是否上报一阶段成功	client.rm.reportSuccessEnable	false	true用于保持分支事务生命周期记录完整，false可提高不少性能。
异步提交缓存队列长度	client.rm.asyncCommitBufferLimit	10000	二阶段提交成功，RM异步清理undo队列
校验或占用全局锁重试间隔	client.rm.lock.retryInterval	10，单位毫秒
校验或占用全局锁重试次数	client.rm.lock.retryTimes	30
分支事务与其它全局回滚事务冲突时锁策略	client.rm.lock.retryPolicyBranchRollbackOnConflict	true	优先释放本地锁让回滚成功
一阶段结果上报TC重试次数	client.rm.reportRetryCount	5次
自动刷新缓存中的表结构	client.rm.tableMetaCheckEnable	false
定时刷新缓存中表结构间隔时间	client.rm.tableMetaCheckerInterval	60秒
是否开启saga分支注册	client.rm.sagaBranchRegisterEnable	false	Saga模式中分支状态存储在状态机本地数据库中，可通过状态机进行提交或回滚，为提高性能可考虑不用向TC注册Saga分支
saga模式中数据序列化方式	client.rm.sagaJsonParser	默认fastjson	可选jackson

NOTE：更多详见：client 端配置项参考。

事务模式

AT 模式

前提

• 基于支持本地 ACID 事务的关系型数据库。
• Java 应用，通过 JDBC 访问数据库。

整体机制

两阶段提交协议的演变：

• 一阶段：业务数据和回滚日志记录在同一个本地事务中提交，释放本地锁和连接资源。

• 二阶段：

  提交异步化，非常快速地完成。
  回滚通过一阶段的回滚日志进行反向补偿。

写隔离

• 一阶段本地事务提交前，需要确保先拿到全局锁。
• 拿不到全局锁 ，不能提交本地事务。
• 拿全局锁的尝试被限制在一定范围内，超出范围将放弃，并回滚本地事务，释放本地锁。

以一个示例来说明：

两个全局事务 tx1 和 tx2，分别对 a 表的 m 字段进行更新操作，m 的初始值 1000。

tx1 先开始，开启本地事务，拿到本地锁，更新操作 m = 1000 - 100 = 900。本地事务提交前，先拿到该记录的全局锁，本地提交释放本地锁。 tx2 后开始，开启本地事务，拿到本地锁，更新操作 m = 900 - 100 = 800。本地事务提交前，尝试拿该记录的全局锁，tx1 全局提交前，该记录的全局锁被 tx1 持有，tx2 需要重试等待全局锁。

tx1 二阶段全局提交，释放全局锁。tx2 拿到全局锁提交本地事务。

如果 tx1 的二阶段全局回滚，则 tx1 需要重新获取该数据的本地锁，进行反向补偿的更新操作，实现分支的回滚。

此时，如果 tx2 仍在等待该数据的全局锁，同时持有本地锁，则 tx1 的分支回滚会失败。分支的回滚会一直重试，直到 tx2 的全局锁等锁超时，放弃全局锁并回滚本地事务释放本地锁，tx1 的分支回滚最终成功。

因为整个过程全局锁在 tx1 结束前一直是被 tx1 持有的，所以不会发生脏写的问题。

读隔离

在数据库本地事务隔离级别读已提交（Read Committed）或以上的基础上，Seata（AT 模式）的默认全局隔离级别是读未提交（Read Uncommitted）。

如果应用在特定场景下，必需要求全局的读已提交，目前 Seata 的方式是通过 SELECT FOR UPDATE 语句的代理。

SELECT FOR UPDATE 语句的执行会申请全局锁，如果全局锁被其他事务持有，则释放本地锁（回滚 SELECT FOR UPDATE 语句的本地执行）并重试。这个过程中，查询是被 block 住的，直到全局锁拿到，即读取的相关数据是已提交的，才返回。

出于总体性能上的考虑，Seata 目前的方案并没有对所有 SELECT 语句都进行代理，仅针对 FOR UPDATE 的 SELECT 语句。

工作机制

以一个示例来说明整个 AT 分支的工作过程。

业务表：product

Field	Type	Key
id	bigint(20)	PRI
name	varchar(100)
since	varchar(100)

AT 分支事务的业务逻辑：

$ update product set name = 'GTS' where name = 'TXC';

一阶段

过程：

1. 解析 SQL：得到 SQL 的类型（UPDATE），表（product），条件（where name = 'TXC'）等相关的信息。

2. 查询前镜像：根据解析得到的条件信息，生成查询语句，定位数据。

   $ select id, name, since from product where name = 'TXC';

   得到前镜像：

   id	name	since
   1	TXC	2014

3. 执行业务 SQL：更新这条记录的 name 为 'GTS'。

4. 查询后镜像：根据前镜像的结果，通过 主键 定位数据。

   $ select id, name, since from product where id = 1;

   得到后镜像：

   id	name	since
   1	GTS	2014

5. 插入回滚日志：把前后镜像数据以及业务 SQL 相关的信息组成一条回滚日志记录，插入到 UNDO_LOG 表中。

   {
   "branchId": 641789253,
   "undoItems": [{
   "afterImage": {
   "rows": [{
       "fields": [{
           "name": "id",
           "type": 4,
           "value": 1
       }, {
           "name": "name",
           "type": 12,
           "value": "GTS"
       }, {
           "name": "since",
           "type": 12,
           "value": "2014"
       }]
   }],
   "tableName": "product"
   },
   "beforeImage": {
   "rows": [{
       "fields": [{
           "name": "id",
           "type": 4,
           "value": 1
       }, {
           "name": "name",
           "type": 12,
           "value": "TXC"
       }, {
           "name": "since",
           "type": 12,
           "value": "2014"
       }]
   }],
   "tableName": "product"
   },
   "sqlType": "UPDATE"
   }],
   "xid": "xid:xxx"
   }

6. 提交前，向 TC 注册分支：申请 product 表中，主键值等于 1 的记录的 全局锁 。

7. 本地事务提交：业务数据的更新和前面步骤中生成的 UNDO LOG 一并提交。

8. 将本地事务提交的结果上报给 TC。

二阶段-回滚

1. 收到 TC 的分支回滚请求，开启一个本地事务，执行如下操作。

2. 通过 XID 和 Branch ID 查找到相应的 UNDO LOG 记录。

3. 数据校验：拿 UNDO LOG 中的后镜与当前数据进行比较，如果有不同，说明数据被当前全局事务之外的动作做了修改。这种情况，需要根据配置策略来做处理，详细的说明在另外的文档中介绍。

4. 根据 UNDO LOG 中的前镜像和业务 SQL 的相关信息生成并执行回滚的语句：

   $ update product set name = 'TXC' where id = 1;

5. 提交本地事务。并把本地事务的执行结果（即分支事务回滚的结果）上报给 TC。

二阶段-提交

1. 收到 TC 的分支提交请求，把请求放入一个异步任务的队列中，马上返回提交成功的结果给 TC。

2. 异步任务阶段的分支提交请求将异步和批量地删除相应 UNDO LOG 记录。

   NOTE：关于回滚日志表详情，可以从 Seata 官方回滚日志表详情查看：回滚日志表。

TCC 模式

回顾总览中的描述：一个分布式的全局事务，整体是两阶段提交的模型。全局事务是由若干分支事务组成的，分支事务要满足两阶段提交的模型要求，即需要每个分支事务都具备自己的：

• 一阶段 prepare 行为
• 二阶段 commit 或 rollback 行为

根据两阶段行为模式的不同，我们将分支事务划分为 Automatic (Branch) Transaction Mode 和 TCC (Branch) Transaction Mode。

AT 模式基于支持本地 ACID 事务的关系型数据库：

• 一阶段 prepare 行为：在本地事务中，一并提交业务数据更新和相应回滚日志记录。

• 二阶段 commit 行为：马上成功结束，自动异步批量清理回滚日志。

• 二阶段 rollback 行为：通过回滚日志，自动生成补偿操作，完成数据回滚。

  相应的，TCC 模式，不依赖于底层数据资源的事务支持：

• 一阶段 prepare 行为：调用自定义的 prepare 逻辑。

• 二阶段 commit 行为：调用自定义的 commit 逻辑。

• 二阶段 rollback 行为：调用自定义的 rollback 逻辑。

所谓 TCC 模式，是指支持把自定义的分支事务纳入到全局事务的管理中。

NOTE：关于更多模式如 Saga 模式、XA 模式，可以从 Seata 官方 Saga 模式、XA 模式 页面查看。