go中http请求超时后自动重试需整合超时控制、错误分类、指数退避和次数限制四要素；context.withtimeout仅取消单次请求而不触发重试，必须由显式循环或backoff.retry驱动，且每次重试须新建独立context。
Go 里接口超时后自动重试，不能靠 http.Client.Timeout 或 context.WithTimeout 单独解决——前者只管单次请求死线，后者只管取消不重试。真正要落地，得把「超时控制」「错误分类」「退避策略」「次数限制」四件事串起来，缺一不可。
为什么直接用 context.WithTimeout 不会触发重试
context.WithTimeout 只是给一次调用加截止时间，超时后返回 context.DeadlineExceeded 错误，不会自动再跑一遍。常见错误是把它和重试逻辑混为一谈，结果接口一超时就直接失败，连重试机会都没有。
- 重试必须由外层显式循环或
backoff.Retry驱动 - 每次重试都得新建独立的
context.WithTimeout，否则第二次重试拿到的是已 cancel 的 ctx - 别在循环外建一次 ctx 然后反复传入——
ctx.Err()第一次就返回context.Canceled，后续全是无效重试
如何用 backoff.Retry 实现带超时的重试
推荐用 github.com/cenkalti/backoff/v4，它把策略和执行解耦，且 v4 版本修复了 context 取消传播问题（v3 已归档，别用）。
- 必须用
backoff.WithContext(b, ctx)包裹策略，否则ctx.Done()信号进不去重试循环 - 操作函数里要自己创建子 context：
reqCtx, cancel := context.WithTimeout(ctx, 5*time.Second)，用完立刻cancel() - 别让
http.Client.Timeout生效——设为 0，完全依赖 context 控制超时，避免两者冲突 - 示例关键片段：
err := backoff.Retry(func() error {
reqCtx, cancel := context.WithTimeout(ctx, 5*time.Second)
defer cancel()
resp, err := http.DefaultClient.Do(req.WithContext(reqCtx))
if err != nil {
return err // 连接失败、超时等可重试
}
if resp.StatusCode >= 500 {
return fmt.Errorf("server error: %d", resp.StatusCode)
}
return nil
}, backoff.WithContext(backoff.NewExponentialBackOff(), ctx))
怎么判断哪些错误该重试、哪些该立刻放弃
重试不是万能药。对确定性错误重试，只会放大下游压力，还可能破坏幂等性。
- 只重试临时性错误：
errors.Is(err, context.DeadlineExceeded)、errors.Is(err, net.ErrClosed)、HTTP 状态码502/503/504、gRPCcodes.Unavailable - 跳过永久性错误：
sql.ErrNoRows、json.SyntaxError、HTTP400/401/404、gRPCcodes.NotFound、codes.InvalidArgument - 别用
strings.Contains(err.Error(), "timeout")判断——错误文本可能本地化或变更，且捕获不到net/http.ErrHandlerTimeout这类服务端超时 - 封装统一函数：
shouldRetry(err error) bool，收口所有判定逻辑
重试次数与退避间隔怎么设才合理
最大重试次数不是越多越好，退避间隔也不是越长越稳。生产环境要兼顾响应延迟与系统韧性。
- HTTP API 调用通常设 3～5 次，超过这个数大概率是服务真挂了，继续等不如快速失败
-
backoff.NewExponentialBackOff()默认MaxInterval = 1 * time.Second，太小——第 4 次重试就被截断，建议手动设为30 * time.Second - 务必调
b.Reset()再复用backoff.BackOff实例，否则 attempt 计数器串号，导致重试次数失控 - 加 jitter：默认 v4 就带，避免高并发下所有请求在同一毫秒发起重试，形成脉冲流量
- 最后一次重试前不 sleep——别让成功响应被无谓延迟
最容易被忽略的点是：重试函数内部没检查 ctx.Err() 就直接发请求，或者 HTTP 请求体（如 POST body）没重置，导致第二次开始 body 为空。这些细节不处理，重试机制反而变成 bug 发射器。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
