Go RPC调用需结合错误类型、指数退避+随机抖动、上下文超时和幂等性设计重试机制；仅对连接拒绝、超时、Unavailable/Internal等临时错误重试，对InvalidArgument、PermissionDenied等语义明确错误直接返回。
在 Go 的 RPC 调用中，网络抖动、服务临时不可用或序列化失败都可能导致请求失败。单纯依赖一次调用无法保障可靠性，必须引入有策略的错误重试机制。关键不是“盲目重试”，而是结合错误类型、退避策略、上下文超时和幂等性设计，让重试既有效又安全。
区分可重试与不可重试错误
不是所有错误都适合重试。例如客户端参数校验失败（InvalidArgument）、权限不足（PermissionDenied）或业务逻辑拒绝（如余额不足），重试只会重复失败。而连接拒绝（connection refused）、超时（context deadline exceeded）、服务端内部错误（Internal 或 Unavailable）通常可重试。
建议做法：
- 对
net.OpError、rpc.ErrShutdown、context.DeadlineExceeded、status.Code() == codes.Unavailable || codes.Internal（gRPC 场景）等明确标识临时性问题的错误启用重试 - 对
codes.InvalidArgument、codes.PermissionDenied、codes.NotFound等语义明确的客户端/业务错误直接返回，不重试 - 可通过自定义错误包装器（如
IsTransient(err)函数）统一判断
实现指数退避 + 随机抖动
连续快速重试会加剧服务压力，甚至引发雪崩。推荐使用指数退避（exponential backoff）并加入随机抖动（jitter），避免重试请求同步冲击下游。
立即学习“go语言免费学习笔记（深入）”；
示例（基于标准库 time）：
func retryWithBackoff(ctx context.Context, maxRetries int, fn func() error) error {
var err error
for i := 0; i <= maxRetries; i++ {
if i > 0 {
// 基础延迟：100ms * 2^i，再加最多 ±50ms 抖动
baseDelay := time.Millisecond * 100 * time.Duration(1<<uint(i))
jitter := time.Duration(rand.Int63n(int64(baseDelay / 2)))
delay := baseDelay + jitter
select {
case <-time.After(delay):
case <-ctx.Done():
return ctx.Err()
}
}
err = fn()
if err == nil {
return nil
}
if !isTransientError(err) {
break // 不可重试，立即退出
}
}
return err
}与 Context 超时协同控制
重试不能脱离请求整体生命周期。外部传入的 context.Context 应贯穿整个重试流程，包括每次 RPC 调用的子 Context。
正确做法：
- 每次重试前，用
ctx, cancel := context.WithTimeout(parentCtx, callTimeout)创建新子 Context - 及时调用
cancel()避免 goroutine 泄漏 - 若父 Context 已取消或超时，立即终止重试循环，返回
ctx.Err() - 不要用固定总重试时间（如 “最多重试 5 秒”），而应尊重原始请求的 deadline
确保 RPC 方法具备幂等性
重试天然带来重复执行风险。必须要求被重试的 RPC 方法是幂等的——相同参数多次调用，结果一致且无副作用累积（如创建订单不行，查询用户信息或更新状态为“已处理”可以）。
工程实践建议：
- 在服务端为关键变更操作引入唯一请求 ID（如
X-Request-IDheader 或 RPC metadata），服务端缓存近期 ID 实现去重 - 对非幂等操作（如支付扣款），改用异步+补偿（如发消息、查状态、自动冲正），而非同步重试
- 客户端在重试日志中打上重试次数标记（如
attempt=3），便于问题定位与审计
不复杂但容易忽略。重试不是加个 for 循环就完事，它需要错误分类、节奏控制、上下文约束和语义保障四者配合。做好这几点，RPC 请求的可靠性才能真正落地。
