📚 课程目录第2章事务边界参数概览

2. 事务边界参数概览：常见中间件中的事务边界参数总览

事务边界参数是分布式事务中间件中用于定义事务生命周期、隔离范围、超时控制以及回滚策略的核心配置项。不同中间件对事务边界的抽象层次不同，但最终都围绕 “何时开始、何时提交/回滚、如何隔离、超时如何处理” 这四个维度展开。本章对 Spring 声明式事务、Seata AT/TCC 模式、RocketMQ 事务消息三类常见中间件的事务边界参数进行系统梳理。

学习提示： 事务边界参数直接影响系统的吞吐量、数据一致性级别以及故障恢复能力。建议在阅读参数表格时，结合后续章节的性能调优案例进行对照理解。

2.1 事务边界参数分类模型

事务边界参数可归纳为以下四类，所有中间件的参数配置均可在该分类中找到对应位置：

生命周期控制： 事务超时时间、最大重试次数、悬挂事务清理周期。
隔离范围控制： 事务传播行为、隔离级别、分支事务注册范围。
提交/回滚策略： 提交顺序、回滚触发条件、补偿动作执行器。
监控与日志： 事务状态表清理阈值、日志输出级别、指标采集开关。

2.2 Spring 声明式事务边界参数

Spring 通过 @Transactional 注解和 PlatformTransactionManager 实现事务边界控制。以下为最常用的参数及其说明：

参数名称	默认值	边界含义	典型配置
`propagation`	REQUIRED	定义事务传播行为，决定当前方法是否加入已有事务或创建新事务	REQUIRES_NEW（独立事务）、NESTED（嵌套事务）
`isolation`	DEFAULT	数据库隔离级别，控制脏读、不可重复读、幻读的防护程度	READ_COMMITTED、REPEATABLE_READ
`timeout`	-1（无限制）	事务最大执行秒数，超时自动回滚	5（秒）、10（秒）
`rollbackFor`	RuntimeException	指定触发回滚的异常类型，默认仅运行时异常回滚	Exception.class（所有异常回滚）
`readOnly`	false	标记只读事务，优化数据库连接和锁机制	true（查询场景）

  性能调优要点： 在只读查询场景务必设置 readOnly=true，可减少数据库锁竞争；timeout 建议设置为业务最长响应时间的 1.5~2 倍，避免长事务锁住资源。

2.3 Seata 分布式事务边界参数

Seata 支持 AT（自动补偿）和 TCC（手动补偿）两种模式，事务边界参数分为全局事务参数和分支事务参数两层。

2.3.1 全局事务参数（GlobalTransactionScanner）

参数名称	默认值	边界含义	性能影响
`txServiceGroup`	无	事务分组名称，用于定位 TC 集群	分组合理可减少路由延迟
`enableDegrade`	false	是否开启降级开关，降级后跳过全局事务	降级可避免故障扩散
`disableGlobalTransaction`	false	全局禁用分布式事务	调试或压测时使用

2.3.2 分支事务参数（@GlobalTransactional）

参数名称	默认值	边界含义	典型配置
`timeoutMills`	60000	全局事务超时毫秒数，超时后 TC 主动回滚	30000（短事务）、120000（长事务）
`name`	方法名	全局事务标识，用于监控和日志追踪	自定义业务名称
`lockRetryInterval`	10	分支事务获取全局锁的重试间隔（毫秒）	20（降低锁冲突时 CPU 空转）
`lockRetryTimes`	30	分支事务获取全局锁的最大重试次数	15（减少等待时间）

避坑指南： Seata AT 模式下，lockRetryInterval 与 lockRetryTimes 的乘积应小于全局超时时间，否则分支事务会在全局超时后继续重试，造成资源浪费。建议乘积 ≤ timeoutMills × 0.8。

2.4 RocketMQ 事务消息边界参数

RocketMQ 事务消息通过半消息（Half Message）和事务回查机制实现最终一致性。事务边界参数集中在生产者端和 Broker 端。

2.4.1 生产者端参数

参数名称	默认值	边界含义	配置建议
`transactionTimeOut`	6000	事务状态回查超时时间（毫秒）	根据本地事务执行时间调整
`maxCheckTimes`	15	事务状态最大回查次数，超过后标记为未知	网络不稳定时可适当增大
`checkInterval`	60000	回查间隔（毫秒），Broker 向生产者询问事务状态	建议 ≥ 5000，避免频繁回查

2.4.2 Broker 端参数

参数名称	默认值	边界含义	性能影响
`transactionCheckInterval`	60000	Broker 扫描半消息队列的间隔（毫秒）	间隔越小，事务状态收敛越快，但 CPU 开销增加
`transactionCheckMax`	15	单条半消息的最大回查次数	超过后消息进入死信队列
`transactionTimeOut`	6000	半消息超时时间，超时后触发回查	应与生产者端保持一致

2.5 参数对比与选型建议

下表从事务边界控制的核心维度对三种中间件进行横向对比：

控制维度	Spring 声明式事务	Seata 分布式事务	RocketMQ 事务消息
超时控制	timeout（秒级）	timeoutMills（毫秒级）	transactionTimeOut（毫秒级）
隔离范围	isolation + propagation	全局锁 + 分支事务注册	半消息 + 回查机制
回滚触发	rollbackFor 异常类型	超时 / 业务异常 / 手动回滚	回查失败 / 业务回滚
重试策略	无内置重试	lockRetryInterval + lockRetryTimes	maxCheckTimes + checkInterval
适用场景	单体应用、单数据库	跨库、跨服务强一致性	跨服务最终一致性

选型建议： 对于需要强一致性的跨库事务，优先选择 Seata AT 模式并合理配置 lockRetryInterval 和 timeoutMills；对于可以接受短暂不一致的跨服务场景，RocketMQ 事务消息配合 maxCheckTimes=5 和 checkInterval=10000 可在性能与一致性之间取得较好平衡。