Go 中实现 HTTP 请求重试需控制次数、指数退避延迟、错误类型判断（仅重试网络错误或 5xx），并解耦重试逻辑与 HTTP 调用，推荐用函数选项封装 DoWithRetry。
在 Go 中实现 HTTP 请求重试，关键不是简单地循环调用 http.Do，而是要有可控的重试次数、可配置的延迟策略（如指数退避）、错误类型判断（比如只重试网络错误或 5xx，跳过 4xx），以及避免阻塞主逻辑。下面用自定义函数 + 回退机制（backoff）来实现一个实用、可复用的重试方案。
定义带退避策略的重试函数
使用指数退避（exponential backoff）是最常见的回退机制：每次失败后等待时间翻倍（加上随机抖动防雪崩）。Go 标准库没有直接提供，但可以用 time.Sleep 自行实现：
- 基础参数包括最大重试次数、初始延迟（如 100ms）、乘数（通常为 2）、最大延迟上限（防过度等待）
- 每次重试前计算当前延迟：
delay = min(initial * (multiplier ^ attempt), maxDelay) - 建议加入 jitter（如 ±10% 随机偏移），避免大量请求在同一时刻重试
区分可重试与不可重试的错误
不是所有错误都该重试。例如：
- ✅ 可重试：连接被拒绝（
net.OpError）、超时（context.DeadlineExceeded）、服务端临时错误（HTTP 500/502/503/504） - ❌ 不可重试：客户端错误（HTTP 400/401/403/404）、JSON 解析失败、URL 格式错误、空响应体等业务或协议层问题
- 实际中建议封装一个
shouldRetry(err error, resp *http.Response) bool函数做统一判断
封装可重试的 HTTP 客户端调用
把重试逻辑和 HTTP 调用解耦，推荐用函数选项（functional options）或结构体配置方式。示例核心逻辑：
立即学习“go语言免费学习笔记（深入）”；
func DoWithRetry(client *http.Client, req *http.Request, opts ...RetryOption) (*http.Response, error) {
o := applyOptions(opts...) // 合并配置
var lastErr error
for i := 0; i <= o.maxRetries; i++ {
resp, err := client.Do(req)
if err == nil && isRetryableStatusCode(resp.StatusCode) {
err = fmt.Errorf("HTTP %d", resp.StatusCode)
}
if err == nil {
return resp, nil
}
lastErr = err
if i == o.maxRetries || !shouldRetry(err, nil) {
break
}
delay := calculateBackoff(i, o.initialDelay, o.multiplier, o.maxDelay)
time.Sleep(delay)
// 注意：若需重试 POST/PUT 等非幂等请求，应确保 req.Body 可重放（如用 bytes.NewReader）
}
return nil, lastErr
}注意请求体重放与上下文传递
默认 http.Request.Body 是单次读取的，重试时会因 body 已关闭或 EOF 导致失败：
- 对小数据：提前读取 body 到内存（
bytes.Buffer或[]byte），每次重试重建req.Body = io.NopCloser(bytes.NewReader(data)) - 对大文件上传：考虑是否真的适合重试；否则改用分块上传 + 断点续传
- 始终把原始
context.Context传入http.Client，并在重试中保留 cancel/timeout 控制力
基本上就这些。不复杂但容易忽略细节——尤其是错误分类和 body 重放。用好指数退避 + 精准重试判断，就能让 HTTP 客户端稳得多。
