必须用context.WithTimeout配defer cancel(),因不调用cancel会导致底层timer和goroutine持续泄漏;超时需沿调用链传递并每个阻塞点监听ctx.Done(),仅time.Sleep或time.After无法真正终止任务。

Go 函数处理超时,不能只靠 time.Sleep 或 time.After 硬等,必须用 context.WithTimeout 沿调用链向下传递,并让每个阻塞点主动监听 ctx.Done() —— 否则超时只是“看起来生效”,goroutine 仍在后台泄漏。
为什么 context.WithTimeout 必须配 defer cancel()
不调用 cancel() 不是“忘了清理”,而是会真实泄漏资源:底层 time.Timer 和配套 goroutine 不会自动停,持续占用调度器和内存。哪怕函数提前 return、出错退出、甚至没走到超时那步,cancel() 也必须执行。
-
context.WithTimeout返回的cancel是释放 timer 的唯一出口,不是可选项 - 只在
ctx.Err() != nil时才调cancel()是错的——那时 timer 已经跑完,泄漏已发生 - 正确姿势:用两个变量接收,立刻加
defer cancel(),不管后续逻辑是否成功
HTTP 请求中 context 失效的三个典型写法
最常见的“超时不生效”,根本不是 context 没设,而是它根本没进到底层网络栈。
- 错误:
req = req.WithContext(ctx); client.Do(req)——Do内部读的是旧req,context 被丢弃 - 正确:
client.Do(req.WithContext(ctx))或先赋值再调用,确保传入的是带 context 的指针 - 更隐蔽的坑:
http.Client.Timeout只控制读/写阶段,无法覆盖 DNS 解析、TLS 握手、连接池等待;只有context能统一约束全链路 - 进阶补漏:
http.Transport.DialContext必须设置,否则建连卡死时ctx仍无响应
监听取消只能用 select,不能轮询 ctx.Err()
ctx.Err() 是快照值,不是信号源。它在取消前恒为 nil,轮询等同于空转 CPU,且永远收不到“刚发生的取消”。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
立即学习“go语言免费学习笔记(深入)”;
- 阻塞操作(如
time.Sleep、ch 、<code>)必须包裹在 <code>select { case 中 - 非阻塞循环里,每次迭代开头都应有
select分支监听ctx.Done(),不能用if ctx.Err() != nil替代 -
ctx.Done()是一个永不为nil的 channel,关闭后所有接收操作立即返回,这是select唯一可靠的触发机制
WithValue 的 key 为什么不能用 string
用字符串当 key 看似简单,实则埋下运行时覆盖风险:不同包、不同模块可能无意中用相同字符串(比如都用 "user_id"),导致值被静默覆盖,且编译期完全无法发现。
- 正确做法:定义私有类型作 key,例如
type userIDKey struct{},再用ctx = context.WithValue(ctx, userIDKey{}, 123) - 业务参数(如用户 ID、trace ID)可以放,但禁止传结构体、切片、函数等大对象或状态可变值
- 更推荐方案:把必要元数据提前注入 handler 入参,而非依赖
WithValue—— 它是兜底手段,不是主力传参方式
真正难的不是写对第一层 WithTimeout,而是确保它穿透整个调用链:从 HTTP handler → service 层 → DB 查询 → 第三方 SDK。任何一个环节漏传、漏监听、漏 cancel,整条链就断了信号。这要求团队对 context 的使用形成统一约定,而不是靠某个人“记得加”。

















