架构与系统设计 / 系统课时

理解透明重试与提交边界

理解透明重试与提交边界

gRPC 的一次逻辑 RPC 可能在底层经历多个 attempt。判断失败能否由库自动重放,不能只看最终状态码,还要判断请求是否进入服务端应用,以及客户端是否已经越过 gRPC 的重试提交边界。

学习目标

  • 区分逻辑 RPC、RPC attempt 与 transparent retry
  • 判断透明重试适用的低层安全场景
  • 理解响应头与重试缓冲区形成的提交边界

一次 RPC 可能包含多个 attempt

应用调用一次 stub 方法,看到的是一个逻辑 RPC;gRPC 为处理连接竞态或执行配置的重试策略,可能在底层创建新的 attempt。新的 attempt 会重新建立流并重放仍在重试缓冲区中的出站消息,但对应用仍表现为同一次调用。

transparent retry 与显式 retryPolicy 不等价。即使没有配置重试策略,只要实现启用了重试能力,gRPC 仍可能在能够确认服务端应用没有处理请求的低层场景中透明重放。它解决的是传输层竞态,而不是根据业务状态码随意重复调用。

gRPC 透明重试与响应头提交边界

因此,日志里可能只看到应用发起一次调用,却在底层观察到多个 attempt。治理时应分别观察逻辑调用结果与 attempt 级行为,否则容易把库内部恢复误判为应用主动重试。

透明重试只覆盖能够证明安全的阶段

透明重试依据的是 gRPC 能否确认当前 attempt 没有进入服务端应用逻辑,而不是开发者主观判断某个方法“看起来可以重试”。

失败位置 gRPC 的处理边界
RPC 尚未离开客户端 可以继续透明重试,直到成功或逻辑 RPC 的 deadline 到期
请求到达服务端 gRPC 库,但尚未交给应用 最多额外执行一次透明重试
服务端应用可能已经看到请求 不再属于能够证明安全的透明重试场景
客户端已经收到响应头 逻辑 RPC 已提交,不再创建新的重试 attempt

如果服务端已经写入数据库,只是响应在返回途中丢失,客户端不能依赖 transparent retry 自动恢复业务语义。此时是否再次调用,必须由业务幂等性、幂等键或状态查询机制决定。

响应头和缓冲区构成提交边界

客户端收到服务端 initial metadata,也就是响应头后,RPC 对重试机制而言已经提交。即使后续响应消息或 trailers 因网络故障没有完整到达,gRPC 也不会再为这个逻辑调用创建新的重试 attempt。

另一个提交条件来自重试缓冲区。为了重新发送请求,客户端必须保存可重放的出站消息;如果某个 RPC 缓冲的数据超过实现允许的重试缓冲上限,该 RPC 将不再具备继续重试所需的缓存。这个边界对 Client Streaming 和双向流尤其重要,因为出站消息会持续累积。

“已提交”只描述客户端重试状态机,不代表数据库事务已经提交,也不代表客户端已经获得完整响应。对 Streaming RPC,服务端可能较早发送响应头,因此不能依赖自动重试恢复已经开始返回数据的流。

retryPolicy 扩大可重试范围

下面的 Service Config 为 GetQuote 配置策略化重试。它不是启用 transparent retry 的必要条件,而是允许尚未提交的调用在满足状态码、attempt 上限和退避条件时继续尝试。

json
{
  "methodConfig": [
    {
      "name": [
        {
          "service": "checkout.CheckoutService",
          "method": "GetQuote"
        }
      ],
      "retryPolicy": {
        "maxAttempts": 4,
        "initialBackoff": "0.1s",
        "maxBackoff": "1s",
        "backoffMultiplier": 2,
        "retryableStatusCodes": ["UNAVAILABLE"]
      }
    }
  ]
}

预期结果:配置生效后,GetQuote 若在 RPC 尚未提交时以 UNAVAILABLE 结束,可按照该策略继续重试,配置允许的总 attempt 数最多为 4。具体退避间隔可能包含随机化,不应依赖精确时间值做断言。

验证时可结合客户端 attempt 指标、服务端请求日志或故障注入,对比一次逻辑调用对应的实际 attempt 数。对写 RPC,只有具备业务幂等性、幂等键或等价去重机制时,才应允许可能已经进入服务端应用的失败参与策略化重试。

排查重复执行时先确认边界

遇到“为什么这次调用执行了两次”,先确认观察到的是一个逻辑 RPC 的多个 attempt,还是应用层真正发起了两次调用;再检查客户端是否已经收到响应头,以及第一次 attempt 是否可能进入服务端应用。

把这几个边界分开后,transparent retry、retryPolicy 和业务主动重放就不会混成同一个概念:前者只处理能够证明安全的低层竞态,后两者则必须接受并治理重复执行风险。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

理解透明重试与提交边界

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通