17370845950

在 Go 中实现网络请求超时与重试需组合 context.Context 与 http.Client：用 context.WithTimeout 控制全链路超时并及时 cancel；Client 级超时仅作兜底；重试应基于错误类型判断、指数退避、新建 request 和 context，并封装为可复用接口。

在 Go 中实现网络请求的超时控制和重试逻辑，核心是组合 context.Context 与 http.Client 的超时配置，并封装可重试的请求逻辑。不依赖第三方库也能做到简洁可靠。

用 context 控制单次请求超时

HTTP 客户端本身支持超时，但更推荐用 context.WithTimeout 统一管理——它能中断阻塞的 DNS 解析、连接建立、TLS 握手和响应读取全过程。

• 创建带超时的 context：ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
• 把 ctx 传给 http.NewRequestWithContext(ctx, ...)
• 务必调用 cancel() 避免 goroutine 泄漏（即使请求已结束）
• 检查错误是否为 context.DeadlineExceeded 可区分超时和其他失败

设置 http.Client 级别超时（辅助但非替代 context）

Client 的 Timeout 字段仅作用于整个请求生命周期（从发起到收到完整响应），无法中断中间阶段；而 Transport 的各字段（如 DialContextTimeout）可精细控制底层行为。

• 建议至少设置 Transport.DialContext 超时（连接建立）和 ResponseHeaderTimeout（等待响应头）
• 示例：client := &http.Client{Timeout: 10 * time.Second} 是兜底，不能代替 context
• 避免同时设 Client.Timeout 和 context 超时，容易造成语义混淆

实现简单可靠的重试逻辑

重试不是无脑循环，需满足：可重试条件判断、指数退避、最大重试次数限制、上下文取消传播。

• 只对临时性错误重试：如网络不通、5xx、部分 4xx（429 Too Many Requests）、context.DeadlineExceeded（说明上次超时可能只是抖动）
• 跳过不可重试错误：如 400、401、403、404、TLS 证书错误、URL 解析失败等
• 用 time.Sleep(backoff) 实现退避，初始 100ms，每次 ×2，上限 1s（避免雪崩）
• 每次重试都新建 request 并传入新 context（含剩余超时时间），不要复用旧 request

封装一个可复用的 retryable HTTP 客户端

把上述逻辑收拢成一个函数或结构体，对外暴露 clean 接口：

• 输入：method、url、body、重试次数、基础超时
• 内部自动派生 context，计算剩余超时，执行带退避的重试
• 返回 *http.Response 和 error；error 包含最后一次失败原因，便于上层分类处理
• 可选支持自定义重试判定函数（比如根据响应 body 内容决定是否重试）

不复杂但容易忽略细节，关键是 context 生命周期、错误分类和退避节奏。