默认的 http.Client 不会自动重试，仅在极少数 HTTP/2 场景内部重发帧，业务层需手动实现重试逻辑，包括错误判断、请求复制、指数退避与上下文控制。
为什么默认的 http.Client 不会自动重试
Go 标准库的 http.Client 在遇到网络错误（如连接超时、DNS 失败、TLS 握手失败）时会直接返回错误，不会重试。它只在极少数 HTTP/2 场景下对某些可重试帧做内部重发，但这不等价于业务层的请求重试逻辑。
这意味着：如果一次 client.Do(req) 返回 context.DeadlineExceeded 或 net.OpError，你就得自己决定是否重发、重发几次、间隔多久。
- 重试不是 HTTP 协议层义务，而是客户端业务策略
-
http.Transport的MaxIdleConns等参数影响连接复用，但和重试无关 - GET 请求通常可安全重试；POST/PUT 等非幂等请求必须谨慎，否则可能造成重复提交
手动实现带退避的重试逻辑（推荐基础方案）
最可控的方式是封装一层重试逻辑，配合 context 控制总超时与取消，用指数退避避免雪崩。
func doWithRetry(client *http.Client, req *http.Request, maxRetries int) (*http.Response, error) {
var resp *http.Response
var err error
for i := 0; i <= maxRetries; i++ {
resp, err = client.Do(req)
if err == nil {
return resp, nil
}
// 只对可重试错误重试：连接类、临时性错误
if !isRetryableError(err) {
return nil, err
}
if i == maxRetries {
break
}
// 指数退避：100ms, 200ms, 400ms...
time.Sleep(time.Duration(100*math.Pow(2, float64(i))) * time.Millisecond)
}
return resp, err}
立即学习“go语言免费学习笔记（深入）”；
func isRetryableError(err error) bool {
if urlErr, ok := err.(*url.Error); ok {
if netErr, ok := urlErr.Err.(net.Error); ok && netErr.Temporary() {
return true
}
}
return strings.Contains(err.Error(), "timeout") ||
strings.Contains(err.Error(), "connection refused") ||
strings.Contains(err.Error(), "i/o timeout")
}
- 把原始
req复制一份再传入client.Do()，避免 Body 被 consume 后无法重放（特别是含bytes.Reader或strings.Reader时） - 使用
req.Clone(context.Background())安全复制请求（含 Header、Body、URL），但注意 Body 需要能重复读（如用bytes.NewBuffer构造） - 不要在循环里反复修改同一个
req.Header，可能导致并发问题
用第三方库 golang.org/x/time/rate + backoff 更可靠
手写退避容易出错（比如没处理 jitter、没限制最大间隔）。更稳妥的做法是用成熟 backoff 库，例如 github.com/cenkalti/backoff/v4。
import "github.com/cenkalti/backoff/v4"func doWithBackoff(client http.Client, req http.Request) (*http.Response, error) { operation := func() error { resp, err := client.Do(req) if err != nil { if isRetryableError(err) { return err } return backoff.Permanent(err) // 永久失败，不再重试 } resp.Body.Close() // 注意：这里只是检查，实际使用需按需读取 return nil }
b := backoff.WithContext(backoff.NewExponentialBackOff(), req.Context()) return nil, backoff.Retry(operation, b)}
-
backoff.Retry自动处理 jitter、max interval、stop condition - 务必用
backoff.WithContext绑定请求上下文，防止重试失控 - 若需获取最终响应，应在
operation中缓存*http.Response到闭包变量，而非仅返回 error - 注意：该库默认重试 8 次，最大间隔约 30 分钟 —— 生产中建议显式配置
MaxElapsedTime
HTTP 重试最容易被忽略的三个点
很多重试逻辑上线后才暴露问题，往往卡在这几个细节上：
-
req.Body是io.ReadCloser，一旦读过就不可重放 —— 必须用可重播 Body（如bytes.NewReader(buf)或封装成自定义ReadSeeker） - 没有区分错误类型，把 400 Bad Request 或 401 Unauthorized 当成网络错误重试，浪费资源且无意义
- 未设置
http.Client.Timeout或http.Transport.DialContext超时，导致单次请求卡死，整个重试流程 hang 住
真正健壮的重试，不是“多试几次”，而是“在正确的时间、对正确的错误、用正确的方式试”。尤其是微服务调用链中，上游重试 + 下游重试 + 负载均衡重试叠加，很容易放大故障。
