context是Go语言中用于管理并发任务生命周期的核心机制，主要功能包括超时控制、取消操作和信号传递。在HTTP请求中实现超时，必须使用context.WithTimeout配合http.Client，并显式监听ctx.Done()通道。
先澄清一个误区：context 跟“网络用语”“语言学习”毫无关系。它是 Go 标准库中专门用于控制并发任务生命周期的关键工具，核心功能集中在三个方向：超时、取消、信号传播。
如果你看到“网络语言学习”这种说法，多半是把“网络请求”（network request）和“网络用语”（internet slang）混淆了。下面直接上干货，只讲真实开发中必须掌握的细节。
HTTP 客户端超时必须使用 context.WithTimeout，不能仅依赖 http.Client.Timeout
很多人认为只要设置了 http.Client.Timeout 就万事大吉，其实并非如此：
http.Client.Timeout仅控制连接建立和响应头读取，响应体读取（例如大文件下载卡在resp.Body.Read）它完全无法覆盖。context.WithTimeout能够覆盖整个请求生命周期：DNS解析、连接建立、TLS握手、写请求、读响应头、读响应体，一个不落。- 两者配合使用效果最佳，但
context更可靠，控制粒度也更精细。
正确写法如下：
ctx, cancel := context.WithTimeout(context.Background(), 5*time.Second)
defer cancel()
req, _ := http.NewRequest("GET", "https://example.com/api", nil)
req = req.WithContext(ctx)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
// 这里的 err 可能是 context.DeadlineExceeded
return
}
defer resp.Body.Close()
ctx.Done() 必须被显式监听，否则超时无法中断正在运行的 goroutine
派生 context.WithTimeout 后，如果不主动检查 ctx.Done()，goroutine 依然会执行完毕，资源照样泄漏——超时设置形同虚设。
- 数据库查询应使用
db.QueryContext替代db.Query。 - 自定义长任务（例如解析大 JSON、压缩文件）必须在循环中通过
select或定期检查ctx.Err() != nil来响应超时。 - 切勿将
ctx存储在结构体字段中；它必须作为第一个参数传递给函数，确保调用链可追溯。
错误示例（超时后仍继续执行）：
go func() {
time.Sleep(10 * time.Second) // 完全无视 ctx
fmt.Println("done")
}()
正确做法：
go func() {
select {
case <-time.After(10 * time.Second):
fmt.Println("done")
case <-ctx.Done():
fmt.Println("canceled:", ctx.Err()) // 输出 context.DeadlineExceeded
return
}
}()
cancel() 必须通过 defer 调用，否则会导致 context 泄漏
context.WithTimeout 和 context.WithCancel 返回的 cancel 函数并非可选项——它是资源清理的关键环节。
- 如果没有调用
cancel()，父 context 的子节点不会被 GC 回收，内存将持续增长。 - 即使超时已经触发，也需要调用
cancel()，否则Done()channel 不会释放。 - 常见陷阱：在 error early return 前忘记调用
cancel()，建议统一使用defer cancel()。
反模式：
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
if someCondition {
return // cancel 没有被调用！
}
defer cancel() // 这行永远不会执行到
超时错误判断不要使用字符串匹配，应使用 errors.Is(err, context.DeadlineExceeded)
在日志或重试逻辑中，经常有人写 strings.Contains(err.Error(), "deadline") ——这种做法不可靠。
context.DeadlineExceeded是导出变量，类型为error，使用errors.Is进行精确判断最为稳妥。- 不同 Go 版本、不同 HTTP 库返回的错误信息可能发生变化，但
context.DeadlineExceeded始终稳定。 - 注意：
context.Canceled是另一类错误（主动取消），与超时不等价。
推荐写法：
if errors.Is(err, context.DeadlineExceeded) {
log.Warn("request timeout", "url", url)
return
}
真正困难的地方不在于写对那几行 context.WithTimeout，而是确保每个下游调用都接收并响应 ctx 参数，并且所有阻塞操作都受其约束。只要有一个 db.Query 没有换成 db.QueryContext，整个超时控制便形同虚设。
