有几个关键点必须反复强调: context.WithTimeout 返回的 cancel 函数必须调用,否则底层的 timer 和 goroutine 会泄漏;HTTP 请求里,一定要确保 client.Do 接收的是带 context 的 *http.Request;监听取消信号,只能用 select <-ctx.Done(),绝对不能轮询 ctx.Err()。

context.WithTimeout 必须配 defer cancel() 吗?
答案是肯定的。context.WithTimeout 返回的 cancel 函数,可不是什么可选配件——它是资源释放的关键一环。
原因在于:超时触发后,Done() 通道关闭、Err() 返回 DeadlineExceeded,但底层的 time.Timer 和它的 goroutine 并不会自动停下。它们还活着,还占着资源,直到你显式清理。
- 不调用
cancel()→ 定时器泄漏,goroutine 持续占用内存和调度资源 - 只在超时后才调用 → 依然晚了,泄漏已发生
- 正确姿势:始终用两个变量接收,且在作用域末尾加
defer cancel(),哪怕任务提前完成或出错也要执行
HTTP 请求中 context 不生效的常见写法
最常见的坑是:你改了请求对象的 context,但 http.Client.Do 根本没收到这个信号。
http.Client 自身的 Timeout 字段无法覆盖 DNS 解析、TLS 握手、连接池等待等环节;只有传入 context 才能统一控制全链路。
- 错误写法:
req = req.WithContext(ctx),然后调用client.Do(req)—— 此时ctx对请求完全无效 - 正确写法:
client.Do(req.WithContext(ctx)),或先赋值再调用,确保Do内部读取的是带 context 的*http.Request - 额外注意:
http.Transport的IdleConnTimeout、DialContext等字段也需配合 context 使用,否则连接建立阶段仍可能卡死
监听取消信号只能用 select,不能 if ctx.Err() != nil
ctx.Err() 在取消前永远是 nil,所以用 if ctx.Err() != nil 或 for ctx.Err() == nil 来轮询,完全没用——既浪费 CPU,又响应不及时。
ctx.Done() 是一个永远非 nil 的 channel,但它是否关闭,只有通过接收操作才能知道——这就是 select 不可替代的原因。
- 阻塞型操作(如
time.Sleep、<-ch)必须包裹在select中,与<-ctx.Done()并列 - 非阻塞循环里,每次迭代开头都应有
select { case <-ctx.Done(): ... default: ... }结构 - 若只做一次检查(比如启动前校验),可用
if err := ctx.Err(); err != nil,但这不是“监听”,只是快照式判断
WithValue 的 key 为什么不能用 string?
因为 string 作为 key 太容易冲突了。不同包、不同模块很可能无意间用了相同的字符串做 key,导致值被覆盖或读错,而且编译期根本发现不了。
Go 官方明确建议用自定义类型(哪怕是个空 struct)作为 key,这样才能保证类型安全和唯一性。
- 错误示范:
ctx = context.WithValue(ctx, "user_id", 123)—— 全局字符串 key 极易撞车 - 正确做法:定义私有类型,如
type userIDKey struct{},再用ctx = context.WithValue(ctx, userIDKey{}, 123) - 更稳妥方案:把 key 定义在包内,对外只暴露获取函数,避免外部直接构造 key
树形继承、单向取消、递归查值——这些机制本身很健壮,但一旦 key 冲突,整个上下文携带的数据就不可信了。这点容易被忽略,却直接影响调试和线上稳定性。