Go 中用 context 控制 HTTP 请求生命周期的核心是将带超时的 context 传给 http.Client.Do:用 context.WithTimeout 创建可取消上下文并务必调用 cancel();通过 req.WithContext 绑定上下文;根据 errors.Is(err, context.DeadlineExceeded) 等判断错误类型。

在 Go 中,用 context 控制 HTTP 请求生命周期的核心是:把带超时的 context 传给 http.Client 的 Do 方法,让请求在超时后自动取消,避免 goroutine 泄漏和资源堆积。
创建带超时的 context
使用 context.WithTimeout 或 context.WithDeadline 生成可取消的上下文。推荐 WithTimeout,语义清晰、使用简单:
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)- 务必在请求结束后调用
cancel(),释放底层 timer 和 goroutine(即使请求已结束,不调用也可能导致轻微泄漏) - 超时时间应略大于预期响应时间,留出网络抖动余量;太短易误判失败,太长影响服务整体响应性
将 context 注入 HTTP 请求
Go 1.13+ 支持直接通过 http.Request.WithContext 替换原请求的 context:
- 先用
http.NewRequest构建基础请求 - 再调用
req = req.WithContext(ctx)绑定上下文 - 最后用标准
client.Do(req)发起请求 - 注意:不能直接修改
req.Context()返回的 context,必须用WithContext创建新请求
处理超时与取消的返回结果
当 context 超时或手动取消时,client.Do 会立即返回错误,需区分错误类型判断原因:
立即学习“go语言免费学习笔记(深入)”;
- 检查
errors.Is(err, context.DeadlineExceeded)—— 明确是超时 - 检查
errors.Is(err, context.Canceled)—— 是主动取消(如父 context 关闭) - 其他错误(如连接拒绝、DNS 失败)与 context 无关,需单独处理
- 即使返回错误,也要确保调用
cancel()(可用defer cancel()简化)
封装成可复用的超时客户端(可选)
若多个地方需要统一超时策略,可封装一个带默认 context 的 client:
- 定义结构体持有
*http.Client和默认超时时间 - 提供
Do(ctx context.Context, req *http.Request) (*http.Response, error)方法,在内部自动注入 context - 避免全局共享一个带固定 timeout 的 client,因为每个请求的超时需求可能不同










