答案是使用自定义RoundTripper实现HTTP重试机制。通过实现http.RoundTripper接口，在RoundTrip方法中包装原始Transport，加入基于状态码、错误类型和指数退避的重试逻辑，控制最大重试次数与延迟，并将该RoundTripper赋值给http.Client的Transport字段，实现稳定可复用的HTTP客户端。
在Golang中处理HTTP重试机制，关键在于控制请求失败后的自动重发行为。默认的 http.Client 不带重试功能，需通过自定义 Transport 和逻辑控制实现。合理设计重试策略能提升服务稳定性，尤其是在网络波动或后端临时不可用时。
使用 RoundTripper 自定义重试逻辑
最灵活的方式是实现 http.RoundTripper 接口，拦截每次HTTP请求并加入重试机制。
- 包装原始 Transport，比如 http.DefaultTransport
- 在 RoundTrip 方法中循环发送请求，直到成功或达到最大重试次数
- 根据响应状态码或错误类型判断是否重试，例如：5xx、429、连接超时等
- 每次重试之间加入延迟，建议使用指数退避避免雪崩
示例代码片段：
type RetryingRoundTripper struct {
Transport http.RoundTripper
MaxRetries int
Backoff func(int) time.Duration // 指数退避函数
}
func (rt RetryingRoundTripper) RoundTrip(req http.Request) (http.Response, error) {
var resp http.Response
var err error
for i := 0; i <= rt.MaxRetries; i++ {
resp, err = rt.Transport.RoundTrip(req)
if err == nil && resp.StatusCode < 500 && resp.StatusCode != 429 {
return resp, nil
}
if err != nil {
// 可重试的网络错误，如连接失败
} else {
resp.Body.Close()
}
if i < rt.MaxRetries {
time.Sleep(rt.Backoff(i))
}
}
return resp, err}
配置可复用的 Client
将自定义 RoundTripper 应用到 http.Client，便于全局使用。
立即学习“go语言免费学习笔记（深入）”；
- 创建 client 实例时指定 Transport 为重试实现
- 设置合理的超时时间（Timeout），避免长时间阻塞
- 注意并发场景下 Transport 是安全的，但需避免频繁重建
示例：
client := &http.Client{
Transport: &RetryingRoundTripper{
Transport: http.DefaultTransport,
MaxRetries: 3,
Backoff: func(attempt int) time.Duration {
return time.Millisecond * time.Duration(100<处理幂等性与副作用
不是所有请求都适合重试。POST 请求通常有副作用，重复提交可能导致数据重复。
- GET、HEAD、PUT、DELETE 一般可安全重试
- POST 需确认接口是否幂等，否则应关闭重试或添加去重机制（如唯一ID）
- 上传大文件或流式请求不适合自动重试，应由业务层控制
借助第三方库简化实现
如果不想从零构建，可用成熟库如 github.com/hashicorp/go-retryablehttp。
- 封装了重试、退避、日志、上下文支持
- 提供 retryablehttp.NewClient()，返回兼容 http.Client 的客户端
- 支持自定义校验函数决定是否重试
基本上就这些。自己实现更轻量，第三方库更全面。选择取决于项目复杂度和维护成本。
