用net/http+time.sleep可实现基础重试:捕获502/503/504或net.operror等错误后sleep再重发,避免对400/401/404重试,注意用time.second而非固定数值防止线性等待。
用 net/http + time.sleep 实现基础重试逻辑
go 标准库不内置重试机制,必须手动控制请求循环。核心是捕获错误、判断是否可重试、等待后重发。http 状态码如 502、503、504 和网络错误(如 net.operror)通常值得重试;而 400、401、404 一般不该重试。
实操建议:
- 每次重试前调用
time.Sleep,避免指数退避写错成线性等待(比如误用固定 1s 而非time.Second * (1 ) - 用
ctx.WithTimeout包裹每次请求,防止某次重试卡死拖垮整体超时 - 别在循环里复用
*http.Request:它含内部状态(如Body已关闭),重试前需重新构造或用req.Clone(ctx)
用 backoff.Retry 避免手写退避逻辑
第三方库 github.com/cenkalti/backoff/v4 提供标准退避策略(指数、常量、自定义),比手写更可靠。它把“判断是否重试”和“等待多久”解耦,你只需提供操作函数和重试条件。
实操建议:
- 传入的函数必须返回
error;若返回nil,重试终止;若返回非空 error,库自动判断是否重试(默认重试所有 error,需配合backoff.WithMaxRetries和自定义backoff.Context控制) - 用
backoff.WithContext(ctx, b)包装退避器,确保整体上下文取消能中断重试循环 - 别忽略
backoff.Stop错误——当重试次数耗尽且最后一次仍失败时,它会返回此 error,需显式检查并处理
重试时如何保持请求体(如 JSON)可重放
HTTP 请求体(req.Body)默认是单次读取的流,重试时若未重置,第二次读将得空内容。常见错误是直接传入 bytes.NewReader(data) 后反复使用同一 *http.Request。
实操建议:
- 对小数据(如 JSON 小于几 MB),构造请求前把 payload 存为
[]byte,每次重试都新建bytes.NewReader(payload) - 避免用
strings.NewReader处理含非 ASCII 字符的 JSON,可能因编码问题导致服务端解析失败 - 若必须用大文件流(如上传),改用支持重放的
io.ReadSeeker(如os.File),并在每次重试前调用body.Seek(0, io.SeekStart)
重试与 Go 的 context 取消如何协同
外部 API 调用链路中,上游 context 可能中途取消(如 HTTP handler 超时),此时重试必须立即停止,否则会浪费资源甚至引发竞态。
实操建议:
- 每次
http.Do都要用req.WithContext(ctx),而不是只在最外层传 context - 在重试循环开头检查
ctx.Err() != nil,若已取消,直接返回该 error,不要进入 sleep 或下一次请求 - 别把重试逻辑包进
http.Transport的RoundTrip替换里——这会影响所有请求,且难以控制 per-request 的重试条件
重试的边界容易模糊:超时设置、错误分类、body 重放、context 中断,四个点只要漏掉一个,就可能让重试变成故障放大器。
大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!











