Go中基础重试应采用指数退避策略,每次失败后休眠时间递增(如100ms→200ms→400ms),并设最大重试次数防无限循环,同时用context.Context控制整体超时。

Go 中用 for + time.Sleep 实现基础重试
最直接的方式是手动循环调用函数,失败后等待再试。关键不是“重试多少次”,而是“等多久再试”——固定间隔容易压垮下游,指数退避更稳妥。
- 每次失败后,休眠时间应递增(如 100ms → 200ms → 400ms),避免雪崩
- 必须设最大重试次数,否则可能无限卡住
- 建议用
context.Context控制整体超时,而不是只管重试次数
func doWithRetry(ctx context.Context, fn func() error, maxRetries int) error {
var err error
delay := 100 * time.Millisecond
for i := 0; i <= maxRetries; i++ {
select {
case <-ctx.Done():
return ctx.Err()
default:
}
err = fn()
if err == nil {
return nil
}
if i < maxRetries {
time.Sleep(delay)
delay *= 2 // 指数退避
}
}
return err
}用 backoff.Retry 避免手写退避逻辑
第三方库 github.com/cenkalti/backoff/v4 封装了标准退避策略,比手写更可靠,也支持 jitter(随机抖动)防同步冲击。
-
backoff.WithMaxRetries包裹原始 backoff,指定最大次数 -
backoff.WithJitter推荐开启,防止大量请求在同一时刻重试 - 注意:该库的
Retry函数接收的是无参函数func() error,需用闭包捕获参数
import "github.com/cenkalti/backoff/v4"func callAPIWithBackoff() error { bo := backoff.WithMaxRetries(backoff.NewExponentialBackOff(), 3) bo = backoff.WithJitter(bo, 0.1) // ±10% 抖动 return backoff.Retry(func() error { _, err := http.Get("https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca") return err }, bo) }
重试时绕过 net/http 连接复用陷阱
HTTP 请求失败后直接重试,若底层连接已损坏但 http.Client 仍复用它,会导致后续请求持续失败。必须确保每次重试都用“干净”的请求上下文。
- 不要复用
*http.Request实例;每次重试都调用http.NewRequest新建 - 禁用连接池复用(仅调试用):
http.DefaultTransport.(*http.Transport).MaxIdleConnsPerHost = 0 - 更稳妥做法:为重试场景单独配置
http.Client,设置短IdleConnTimeout
client := &http.Client{
Transport: &http.Transport{
IdleConnTimeout: 5 * time.Second,
},
}
req, _ := http.NewRequest("GET", "https://www.php.cn/link/46b315dd44d174daf5617e22b3ac94ca", nil)
// 每次重试都重新 NewRequest,不复用 req 实例
哪些错误不该重试?
盲目重试会放大问题。HTTP 状态码、gRPC 错误码、数据库约束冲突等,多数属于“永久性失败”,重试无意义甚至有害。
立即学习“go语言免费学习笔记(深入)”;
- HTTP:4xx 类错误(如
400 Bad Request、404 Not Found、409 Conflict)一般不重试 - gRPC:
codes.InvalidArgument、codes.NotFound、codes.AlreadyExists属于客户端错误,不应重试 - SQL:主键冲突、外键约束失败、CHECK 失败等,重试只会重复报错
- 建议封装一个
shouldRetry(err error) bool函数,集中判断可重试性
网络超时、连接拒绝、5xx 服务端错误、临时限流响应(如 429 Too Many Requests 带 Retry-After)才适合重试。










