4. Saga 超时配置参数详解

在分布式事务压测场景中，Saga 的超时配置直接决定了事务的最终一致性保障能力与系统吞吐上限。错误配置可能导致补偿风暴、资源死锁或事务悬挂。本章对 timeout、retryInterval、maxRetries、compensationTimeout 四个核心参数进行深度拆解，并结合压测场景给出推荐配置策略。

4.1 参数全景与职责边界

四个参数分别控制 Saga 事务的不同生命周期阶段：

4.2 timeout：正向事务执行超时

timeout 定义了 Saga 协调器等待单个参与者（如订单服务、库存服务）返回成功或失败响应的最长时间。超过该时间，协调器将该参与者标记为失败，并触发补偿流程。

• 默认值参考： 5s ~ 30s（取决于业务复杂度）
• 压测影响：
  • 设置过短 → 正常慢查询被误判为失败，引发不必要的补偿，压测成功率骤降。
  • 设置过长 → 线程/连接池被长时间占用，压测并发数虚高但实际吞吐下降。
• 推荐策略： 基于压测 P99 响应时间 × 1.5 ~ 2 倍设定。例如压测中库存服务 P99 = 800ms，则 timeout 设为 1600ms。

// 伪代码示例：基于压测数据动态配置 timeout
long p99Latency = loadTestMetrics.getP99("inventory.deduct");
long timeout = (long)(p99Latency * 1.8);
sagaBuilder.timeout(timeout, TimeUnit.MILLISECONDS);

4.3 retryInterval：重试间隔窗口

retryInterval 控制 Saga 在参与者返回可重试错误（如网络抖动、数据库死锁）后，等待多久发起下一次重试。该参数直接影响压测场景下的“重试风暴”强度。

4.4 maxRetries：重试次数上限

maxRetries 定义了 Saga 对单个参与者失败的最大重试轮次。超过该次数仍未成功，则进入补偿阶段。

• 典型范围： 2 ~ 5 次
• 与 timeout 的关系： 总等待时间 ≈ timeout × (maxRetries + 1) + retryInterval × maxRetries
• 压测建议：
  • 对于幂等性好的服务（如余额扣减），可设 3~5 次。
  • 对于非幂等服务（如库存预占），建议 maxRetries = 0 或 1，直接走补偿避免数据不一致。

// 压测场景：幂等服务 vs 非幂等服务的 maxRetries 配置
// 幂等服务：允许重试
sagaBuilder.maxRetries(3).retryInterval(500, TimeUnit.MILLISECONDS);

// 非幂等服务：禁止重试，直接补偿
sagaBuilder.maxRetries(0);

4.5 compensationTimeout：补偿事务超时

compensationTimeout 是 Saga 中最容易被忽视但压测中影响最大的参数。它控制协调器等待补偿操作（如退款、释放库存）完成的最长时间。补偿超时会导致事务处于“悬挂”状态，无法最终一致。

4.6 参数协同关系图

下图展示了四个参数在 Saga 事务生命周期中的协同关系，以及压测场景下各参数的决策路径：

4.7 压测场景参数配置速查表

以下表格总结了不同压测场景下的推荐参数组合，可直接作为配置基线：