跳到主要内容
版本:v1.8

seata 参数配置

关注属性(详细描述见全属性)

server 端client 端
registry.typeregistry.type
config.typeconfig.type
#store.mode=db 需要以下配置service.vgroupMapping.my_test_tx_group
store.db.driverClassNameservice.default.grouplist
store.db.urlservice.disableGlobalTransaction
store.db.user
store.db.password
#store.mode=redis 需要以下配置
store.redis.host
store.redis.port
store.redis.database
store.redis.password

全属性

公共部分

keydescremarkchange record
transport.typesocket 通信方式TCP、UNIX_DOMAIN_SOCKET,默认 TCP
transport.serversocket 通道类型NIO、NATIVE(根据操作系统类型和 socket 通信方式选择 KQueue 或 Epoll,注意 Windows 只支持 NIO,选择这种方式会抛出异常)
transport.threadFactory.bossThreadSizeNetty 通信模型 Boss group 线程数默认 1
transport.threadFactory.workerThreadSizeNetty 通信模型 Worker group 线程数可配置线程数或选择特定线程工作模式下的线程数,线程的默认工作模式有 4 种:Auto(2*CPU 核数 + 1)、Pin(CPU 核数,适用于计算密集型任务)、BusyPin(CPU 核数 + 1,适用于计算密集型且内存比较有限的场景)、Default(2*CPU 核数,适用于 IO 密集型任务),默认值为 Default 模式
transport.shutdown.wait服务端 Netty 线程池关闭前等待服务下线时间默认 3 秒
transport.serializationclient 和 server 通信编解码方式seata(ByteBuf)、protobuf、kryo、hessian、fst,默认 seata
transport.compressorclient 和 server 通信数据压缩方式none、gzip、zip、sevenz、bzip2、lz4、deflater、zstd,默认 none1.2.0 之前:gzip
1.2.0:zip、sevenz、bzip2
1.3.0:lz4
1.4.1:deflater
1.5.1:zstd
transport.heartbeatclient 和 server 通信心跳检测开关默认 true 开启
transport.heartbeatclient 和 server 通信心跳检测开关默认 true 开启
registry.type注册中心类型默认 file,支持 file 、nacos 、redis、eureka、zk、consul、etcd3、sofa、custom1.6.0 版本 Sever 端支持可同时注册到多个注册中心,以逗号分隔注册中心名
config.type配置中心类型默认 file,支持 file、nacos 、apollo、zk、consul、etcd3、springcloud、custom

server 端

keydescremarkchange record
transport.enableTcServerBatchSendResponseTC 批量发送回复消息开关默认 false1.5.1 版本新增,建议为 true,可解决 client 批量消息时的线头阻塞问题
transport.rpcTcRequestTimeoutTC 二阶段下发请求超时时间默认 30 秒1.5.1 版本新增
server.undo.logSaveDaysundo 保留天数默认 7 天,log_status=1(附录 3)和未正常清理的 undo
server.undo.logDeletePeriodundo 清理线程间隔时间默认 86400000,单位毫秒
server.maxCommitRetryTimeout二阶段提交重试超时时长单位 ms,s,m,h,d,对应毫秒,秒,分,小时,天,默认毫秒。默认值-1 表示无限重试。公式: timeout>=now-globalTransactionBeginTime,true 表示超时则不再重试(注: 达到超时时间后将不会做任何重试,有数据不一致风险,除非业务自行可校准数据,否者慎用)
server.maxRollbackRetryTimeout二阶段回滚重试超时时长同 commit
server.recovery.committingRetryPeriod二阶段提交未完成状态全局事务重试提交线程间隔时间默认 1000,单位毫秒
server.recovery.asynCommittingRetryPeriod二阶段异步提交状态重试提交线程间隔时间默认 1000,单位毫秒
server.recovery.rollbackingRetryPeriod二阶段回滚状态重试回滚线程间隔时间默认 1000,单位毫秒
server.recovery.timeoutRetryPeriod超时状态检测重试线程间隔时间默认 1000,单位毫秒,检测出超时将全局事务置入回滚会话管理器
server.rollbackRetryTimeoutUnlockEnable二阶段回滚超时后是否释放锁默认 false
server.distributedLockExpireTimeSever 端事务管理全局锁超时时间默认 10000,单位毫秒1.5.1 版本新增
server.server.xaerNotaRetryTimeout防止 XA 分支事务悬挂的重试超时时间默认 60000,单位毫秒1.5.1 版本新增
server.session.branchAsyncQueueSize分支事务 Session 异步删除线程池队列大小默认 50001.5.1 版本新增
server.session.enableBranchAsyncRemove分支事务 Session 异步删除开关默认 false1.5.1 版本新增
server.enableParallelRequestHandle对于批量请求消息的并行处理开关默认 true1.6.1 默认为 true,建议为 false,1.6.1 中存在并行处理时数组越界异常
store.mode事务会话信息存储方式file 本地文件(不支持 HA),db 数据库,redis(支持 HA)1.5.1 版本改用 lock 和 session 分离存储
store.lock.mode事务锁信息存储方式file 本地文件(不支持 HA),db 数据库,redis(支持 HA);配置为空时,取 store.mode 配置项值1.5.1 版本新增,session 和 lock 可分离存储
store.session.mode事务回话信息存储方式file 本地文件(不支持 HA),db 数据库,redis(支持 HA);配置为空时,取 store.mode 配置项值1.5.1 版本新增,session 和 lock 可分离存储
store.publicKeydb 或 redis 存储密码解密公钥1.4.2 版本支持
store.file.dirfile 模式文件存储文件夹名默认 sessionStore
store.file.maxBranchSessionSizefile 模式文件存储分支 session 最大字节数默认 16384(16kb),单位 byte
store.file.maxGlobalSessionSizefile 模式文件存储全局 session 最大字节数默认 512b,单位 byte
store.file.fileWriteBufferCacheSizefile 模式文件存储 buffer 最大缓存大小默认 16384(16kb),单位 byte,写入 session 等数据量大于该值时会抛出异常
store.file.flushDiskModefile 模式文件存储刷盘策略默认 async,可选 sync
store.file.sessionReloadReadSizefile 模式文件存储 Server 节点重启后从备份文件中恢复的 session 或 lock key 上限个数默认 100
store.db.datasourcedb 模式数据源类型dbcp、druid、hikari;无默认值,store.mode=db 时必须指定
store.db.dbTypedb 模式数据库类型mysql、oracle、db2、sqlserver、sybaee、h2、sqlite、access、postgresql、oceanbase;无默认值,store.mode=db 时必须指定。
store.db.driverClassNamedb 模式数据库驱动store.mode=db 时必须指定
store.db.urldb 模式数据库 urlstore.mode=db 时必须指定,在使用 mysql 作为数据源时,建议在连接参数中加上rewriteBatchedStatements=true(详细原因请阅读附录 7)
store.db.userdb 模式数据库账户store.mode=db 时必须指定
store.db.passworddb 模式数据库账户密码store.mode=db 时必须指定
store.db.minConndb 模式数据库初始连接数默认 1
store.db.maxConndb 模式数据库最大连接数默认 20
store.db.maxWaitdb 模式获取连接时最大等待时间默认 5000,单位毫秒
store.db.globalTabledb 模式全局事务表名默认 global_table
store.db.branchTabledb 模式分支事务表名默认 branch_table
store.db.lockTabledb 模式全局锁表名默认 lock_table
store.db.queryLimitdb 模式查询全局事务一次的最大条数默认 100
store.db.distributedLockTabledb 模式 Sever 端事务管理全局锁存储表名默认 distributed_lock,多 Sever 集群下保证同时只有一个 Sever 处理提交或回滚1.5.1 版本新增
store.redis.moderedis 模式默认 single,可选 sentinel1.4.2 版本新增 sentinel 模式
store.redis.single.host单机模式下 redis 的 host,兼容 1.4.2 之前的版本,该配置为空时选取 store.redis.host 作为配置项1.4.2 版本新增
store.redis.single.port单机模式下 redis 的 port,兼容 1.4.2 之前的版本,该配置为空时选取 store.redis.port 作为配置项1.4.2 版本新增
store.redis.sentinel.masterNamesentinel 模式下 redis 的主库名称1.4.2 版本新增
store.redis.sentinel.sentinelHostssentinel 模式下 sentinel 的 hosts多 hosts 以逗号分隔1.4.2 版本新增
store.redis.hostredis 模式 ip默认 127.0.0.11.4.2 版本弃用
store.redis.portredis 模式端口默认 63791.4.2 版本弃用
store.redis.maxConnredis 模式最大连接数默认 10
store.redis.minConnredis 模式最小连接数默认 1
store.redis.databaseredis 模式默认库默认 0
store.redis.passwordredis 模式密码(无可不填)默认 null
store.redis.queryLimitredis 模式一次查询最大条数默认 100
metrics.enabled是否启用 Metrics默认 false 关闭,在 False 状态下,所有与 Metrics 相关的组件将不会被初始化,使得性能损耗最低
metrics.registryType指标注册器类型Metrics 使用的指标注册器类型,默认为内置的 compact(简易)实现,这个实现中的 Meter 仅使用有限内存计数,性能高足够满足大多数场景;目前只能设置一个指标注册器实现
metrics.exporterList指标结果 Measurement 数据输出器列表默认 prometheus,多个输出器使用英文逗号分割,例如"prometheus,jmx",目前仅实现了对接 prometheus 的输出器
metrics.exporterPrometheusPortprometheus 输出器 Client 端口号默认 9898

client 端

keydescremarkchange record
transport.enableTmClientBatchSendRequestTM 批量发送请求消息开关默认 false1.5.1 版本新增
transport.enableRmClientBatchSendRequestRM 批量发送请求消息开关默认 true1.5.1 版本新增
transport.rpcRmRequestTimeoutRM 发送请求超时时间默认 30 秒1.5.1 版本新增
transport.rpcTmRequestTimeoutTM 发送请求超时时间默认 30 秒1.5.1 版本新增
seata.enabled是否开启 spring-boot 自动装配true、false,(SSBS)专有配置,默认 true(附录 4)
seata.enableAutoDataSourceProxy=true是否开启数据源自动代理true、false,seata-spring-boot-starter(SSBS)专有配置,SSBS 默认会开启数据源自动代理,可通过该配置项关闭.
seata.useJdkProxy=false是否使用 JDK 代理作为数据源自动代理的实现方式true、false,(SSBS)专有配置,默认 false,采用 CGLIB 作为数据源自动代理的实现方式
transport.enableClientBatchSendRequest客户端事务消息请求是否批量合并发送默认 true,false 单条发送
client.log.exceptionRate日志异常输出概率默认 100,目前用于 undo 回滚失败时异常堆栈输出,百分之一的概率输出,回滚失败基本是脏数据,无需输出堆栈占用硬盘空间
service.vgroupMapping.my_test_tx_group事务群组(附录 1)my_test_tx_group 为分组,配置项值为 TC 集群名
service.default.grouplistTC 服务列表(附录 2)仅注册中心为 file 时使用
service.disableGlobalTransaction全局事务开关默认 false。false 为开启,true 为关闭
client.tm.degradeCheck降级开关默认 false。业务侧根据连续错误数自动降级不走 seata 事务(详细介绍请阅读附录 6)
client.tm.degradeCheckAllowTimes升降级达标阈值默认 10
client.tm.degradeCheckPeriod服务自检周期默认 2000,单位 ms.每 2 秒进行一次服务自检,来决定
client.rm.reportSuccessEnable是否上报一阶段成功true、false,从 1.1.0 版本开始,默认 false.true 用于保持分支事务生命周期记录完整,false 可提高不少性能
client.rm.asyncCommitBufferLimit异步提交缓存队列长度默认 10000。 二阶段提交成功,RM 异步清理 undo 队列
client.rm.lock.retryInterval校验或占用全局锁重试间隔默认 10,单位毫秒
client.rm.lock.retryTimes校验或占用全局锁重试次数默认 30
client.rm.lock.retryPolicyBranchRollbackOnConflict分支事务与其它全局回滚事务冲突时锁策略默认 true,优先释放本地锁让回滚成功
client.rm.reportRetryCount一阶段结果上报 TC 重试次数默认 5 次1.4.1 版本新增
client.rm.tableMetaCheckEnable自动刷新缓存中的表结构默认 false1.5.1 版本新增
client.rm.tableMetaCheckerInterval定时刷新缓存中表结构间隔时间默认 60 秒
client.rm.sagaBranchRegisterEnable是否开启 saga 分支注册Saga 模式中分支状态存储在状态机本地数据库中,可通过状态机进行提交或回滚,为提高性能可考虑不用向 TC 注册 Saga 分支,但需考虑状态机的可用性,默认 false
client.rm.sagaJsonParsersaga 模式中数据序列化方式默认 fastjson,可选 jackson1.5.1 版本新增
client.rm.tccActionInterceptorOrdertcc 拦截器顺序默认 Ordered.HIGHEST_PRECEDENCE + 1000,保证拦截器在本地事务拦截器之前执行,也可自定义 tcc 和业务开发的拦截器执行顺序1.5.1 版本新增
client.tm.commitRetryCount一阶段全局提交结果上报 TC 重试次数默认 1 次,建议大于 1
client.tm.rollbackRetryCount一阶段全局回滚结果上报 TC 重试次数默认 1 次,建议大于 1
client.tm.defaultGlobalTransactionTimeout全局事务超时时间默认 60 秒,TM 检测到分支事务超时或 TC 检测到 TM 未做二阶段上报超时后,发起对分支事务的回滚1.4.0 版本新增
client.tm.interceptorOrderTM 全局事务拦截器顺序默认 Ordered.HIGHEST_PRECEDENCE + 1000,保证拦截器在本地事务拦截器之前执行,也可自定义全局事务和业务开发的拦截器执行顺序1.5.1 版本新增
client.undo.dataValidation二阶段回滚镜像校验默认 true 开启,false 关闭
client.undo.logSerializationundo 序列化方式默认 jackson
client.undo.logTable自定义 undo 表名默认 undo_log
client.undo.onlyCareUpdateColumns只生成被更新列的镜像默认 true
client.undo.compress.enableundo log 压缩开关默认 true1.4.1 版本新增
client.undo.compress.typeundo log 压缩算法默认 zip,可选 NONE(不压缩)、GZIP、ZIP、SEVENZ、BZIP2、LZ4、DEFLATER、ZSTD1.4.1 版本新增
client.undo.compress.thresholdundo log 压缩阈值默认值 64k,压缩开关开启且 undo log 大小超过阈值时才进行压缩1.4.1 版本新增
client.rm.sqlParserTypesql 解析类型默认 druid,可选 antlr
参数同步到配置中心使用demo

Nacos

shell:

sh $\{SEATAPATH}/script/config-center/nacos/nacos-config.sh -h localhost -p 8848 -g SEATA_GROUP -t 5a3c7d6c-f497-4d68-a71a-2e5e3340b3ca

参数说明:

-h: host,默认值 localhost

-p: port,默认值 8848

-g: 配置分组,默认值为 'SEATA_GROUP'

-t: 租户信息,对应 Nacos 的命名空间 ID 字段, 默认值为空 ''

Apollo

sh $\{SEATAPATH}/script/config-center/apollo/apollo-config.sh -h localhost -p 8070 -e DEV -a seata-server -c default -n application -d apollo -r apollo -t 3aa026fc8435d0fc4505b345b8fa4578fb646a2c

参数说明:

-h: host,默认值 localhost

-p: port,默认值 8070

-e: 所管理的配置环境,默认值 DEV

-a: Namespace 所属的 AppId,默认值 seata-server

-c: 所管理的配置集群名, 一般情况下传入 default 即可。如果是特殊集群,传入相应集群的名称即可,默认值 default

-n: 所管理的 Namespace 的名称,如果是非 properties 格式,需要加上后缀名,如 sample.yml,默认值 application

-d: item 的创建人,格式为域账号,也就是 sso 系统的 User ID

-r: 发布人,域账号,注意:如果 ApolloConfigDB.ServerConfig 中的 namespace.lock.switch 设置为 true 的话(默认是 false),那么该环境不允许发布人和编辑人为同一人。所以如果编辑人是 zhangsan,发布人就不能再是 zhangsan。

-t: Apollo 管理员在 http://{portal_address}/open/manage.html 创建第三方应用,创建之前最好先查询此 AppId 是否已经创建。创建成功之后会生成一个 token

以上参数说明详情请看:

https://github.com/ctripcorp/apollo/wiki/Apollo%E5%BC%80%E6%94%BE%E5%B9%B3%E5%8F%B0

Consul

sh $\{SEATAPATH}/script/config-center/consul/consul-config.sh -h localhost -p 8500

参数说明:

-h: host,默认值 localhost

-p: port,默认值 8500

Etcd3

sh $\{SEATAPATH}/script/config-center/etcd3/etcd3-config.sh -h localhost -p 2379

参数说明:

-h: host,默认值 localhost

-p: port,默认值 2379

python:

python $\{SEATAPATH}/script/config-center/nacos/nacos-config.py localhost:8848

ZK

sh $\{SEATAPATH}/script/config-center/zk/zk-config.sh -h localhost -p 2181 -z "/Users/zhangchenghui/zookeeper-3.4.14"

参数说明:

-h: host,默认值 localhost

-p: port,默认值 2181

-z: zk 所属路径

附录 1:

事务分组说明。 1.事务分组是什么? 事务分组是seata的资源逻辑,类似于服务实例。在file.conf中的my_test_tx_group就是一个事务分组。 2.通过事务分组如何找到后端集群? 首先程序中配置了事务分组(GlobalTransactionScanner 构造方法的txServiceGroup参数),程序会通过用户配置的配置中心去寻找service.vgroupMapping .事务分组配置项,取得配置项的值就是TC集群的名称。拿到集群名称程序通过一定的前后缀+集群名称去构造服务名,各配置中心的服务名实现不同。拿到服务名去相应的注册中心去拉取相应服务名的服务列表,获得后端真实的TC服务列表。 3.为什么这么设计,不直接取服务名? 这里多了一层获取事务分组到映射集群的配置。这样设计后,事务分组可以作为资源的逻辑隔离单位,当发生故障时可以快速failover。

附录 2:

关于grouplist问题说明下。

  1. 什么时候会用到file.conf中的default.grouplist? 当registry.type=file时会用到,其他时候不读。
  2. default.grouplist的值列表是否可以配置多个? 可以配置多个,配置多个意味着集群,但当store.mode=file时,会报错。原因是在file存储模式下未提供本地文件的同步,所以需要使用store.mode=db,通过db来共享TC集群间数据
  3. 是否推荐使用default.grouplist? 不推荐,如问题1,当registry.type=file时会用到,也就是说这里用的不是真正的注册中心,不具体服务的健康检查机制当tc不可用时无法自动剔除列表,推荐使用nacos 、eureka、redis、zk、consul、etcd3、sofa。registry.type=file或config.type=file 设计的初衷是让用户再不依赖第三方注册中心或配置中心的前提下,通过直连的方式,快速验证seata服务。 4.seata-spring-boot-starter中的配置为什么是grouplist.default,也就是说和file.conf中的default.grouplist写法刚好颠倒了位置? 由于spring-boot本身配置文件语法的要求,这个地方需要将file.conf中的default.grouplist写成grouplist.default,效果是一样的.

附录 3:

log_status=1的是防御性的,是收到全局回滚请求,但是不确定某个事务分支的本地事务是否已经执行完成了,这时事先插入一条branchid相同的数据,插入的假数据成功了,本地事务继续执行就会报唯一索引冲突自动回滚。 假如插入不成功说明表里有数据这个本地事务已经执行完成了,那么取出这条undolog数据做反向回滚操作。

附录 4:

是否开启spring-boot自动装配,如果开启,则会自动配置seata与spring-boot的集成,包括数据源的自动代理以及GlobalTransactionScanner初始化。 注:1.0版本新特性,需依赖seata-spring-boot-starter。

附录 5:

seata1.1.0版本新加入以下注解,用于开启数据源自动代理功能 @EnableAutoDataSourceProxy

attributedescremark
useJdkProxy是否使用 JDK 代理作为数据源自动代理的实现方式false、true,默认 false,采用 CGLIB 作为数据源自动代理的实现方式

1.对于使用seata-spring-boot-starter的方式,默认已开启数据源自动代理,如需关闭,请配置seata.enableAutoDataSourceProxy=false,该项配置默认为true。 如需切换代理实现方式,请通过seata.useJdkProxy=false进行配置,默认为false,采用CGLIB作为数据源自动代理的实现方式。 2.对于使用seata-all的方式,请使用@EnableAutoDataSourceProxy来显式开启数据源自动代理功能。如有需要,可通过该注解的useJdkProxy属性进行代理实现方式 的切换。默认为false,采用CGLIB作为数据源自动代理的实现方式。

附录 6:

关于服务自动降级策略的具体实现介绍:
首先通过读取client.tm.degradeCheck是否为true,决定是否开启自检线程.随后读取degradeCheckAllowTimes和degradeCheckPeriod,确认阈值与自检周期.
假设degradeCheckAllowTimes=10,degradeCheckPeriod=2000
那么每2秒钟会进行一个begin,commit的测试,如果失败,则记录连续失败数,如果成功则清空连续失败数.连续错误由用户接口及自检线程进行累计,直到连续失败次数达到用户的阈值,则关闭Seata分布式事务,避免用户自身业务长时间不可用.
反之,假如当前分布式事务关闭,那么自检线程继续按照2秒一次的自检,直到连续成功数达到用户设置的阈值,那么Seata分布式事务将恢复使用

附录 7:

在store.mode=db,由于seata是通过jdbc的executeBatch来批量插入全局锁的,根据MySQL官网的说明,连接参数中的rewriteBatchedStatements为true时,在执行executeBatch,并且操作类型为insert时,jdbc驱动会把对应的SQL优化成insert into () values (), ()的形式来提升批量插入的性能。 根据实际的测试,该参数设置为true后,对应的批量插入性能为原来的10倍多,因此在数据源为MySQL时,建议把该参数设置为true。