进阶指南
本章节展示 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';
一阶段
过程：
解析 SQL：得到 SQL 的类型（UPDATE），表（product），条件（where name = 'TXC'）等相关的信息。
查询前镜像：根据解析得到的条件信息，生成查询语句，定位数据。
$ select id, name, since from product where name = 'TXC';
得到前镜像：
| id | name | since |
|---|---|---|
| 1 | TXC | 2014 |
执行业务 SQL：更新这条记录的 name 为 'GTS'。
查询后镜像：根据前镜像的结果，通过 主键 定位数据。
$ select id, name, since from product where id = 1;
得到后镜像：
| id | name | since |
|---|---|---|
| 1 | GTS | 2014 |
插入回滚日志：把前后镜像数据以及业务 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"
}提交前，向 TC 注册分支：申请 product 表中，主键值等于 1 的记录的 全局锁 。
本地事务提交：业务数据的更新和前面步骤中生成的 UNDO LOG 一并提交。
将本地事务提交的结果上报给 TC。
二阶段-回滚
收到 TC 的分支回滚请求，开启一个本地事务，执行如下操作。
通过 XID 和 Branch ID 查找到相应的 UNDO LOG 记录。
数据校验：拿 UNDO LOG 中的后镜与当前数据进行比较，如果有不同，说明数据被当前全局事务之外的动作做了修改。这种情况，需要根据配置策略来做处理，详细的说明在另外的文档中介绍。
根据 UNDO LOG 中的前镜像和业务 SQL 的相关信息生成并执行回滚的语句：
$ update product set name = 'TXC' where id = 1;提交本地事务。并把本地事务的执行结果（即分支事务回滚的结果）上报给 TC。
二阶段-提交
收到 TC 的分支提交请求，把请求放入一个异步任务的队列中，马上返回提交成功的结果给 TC。
异步任务阶段的分支提交请求将异步和批量地删除相应 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 模式，是指支持把自定义的分支事务纳入到全局事务的管理中。