重复调用 context.WithCancel 会创建多个互不关联的取消分支,导致资源泄漏;正确做法是仅在入口处单次创建取消上下文,子 goroutine 只接收不新建,且避免在无限循环中 defer cancel。

context.WithCancel 被重复调用,生成多个独立取消通道
树形结构依赖单根传递,但很多人在子 goroutine 内部又调用 context.WithCancel(ctx),以为“再包一层更安全”。结果是:同一父 ctx 派生出多个互不关联的 cancel 函数,调用任一 cancel 都不会影响其他分支。那些没被显式 cancel 的子 ctx 会一直存活,其绑定的 goroutine、timer、channel 等资源全部滞留。
常见错误现象:
- pprof 显示大量
runtime.gopark状态的 goroutine,堆上持续增长的timer或chan对象 - 手动调用上游
cancel()后,下游逻辑仍在执行(比如还在发 HTTP 请求)
正确做法:
- 取消控制必须由**唯一源头**发起,通常只在入口处(如 handler、main goroutine)调用一次
context.WithCancel - 子 goroutine 只接收并使用传入的
ctx,绝不在内部新建context.Background()或再次派生取消 ctx - 若需多路终止信号,应统一用一个
ctx+select多 channel 监听,而非多个 cancel
defer cancel() 在无限循环中永不执行
defer 语义是函数返回时才触发,但很多 context 使用场景包裹在 for 循环里(比如 etcd.Watch、长轮询、事件监听),函数本身永不退出 —— 导致 defer cancel() 压根没机会执行,底层 timer、goroutine、net.Conn 全部泄漏。
典型代码片段:
func etcdWatchLoop() error {
ctx, cancel := context.WithTimeout(context.Background(), time.Second*5)
defer cancel() // ← 这行永远不会运行
wchan := eClient.Watch(ctx, "/foo", clientv3.WithPrefix())
for {
select {
case
<p>解决思路:</p>
- 把 long-running loop 单独抽成函数,让
defer能在该函数退出时生效 - 改用
context.WithCancel+ 显式调用cancel(),在循环退出路径(包括break、return、panic recover)中都确保 cancel 被调用 - 避免在循环体中反复创建新 ctx(如每次 Watch 后再
WithTimeout),这会累积未释放的 timer
子 goroutine panic 后未 recover,导致 ctx.Done() 监听中断
Context 不捕获 panic,也不管理 goroutine 生命周期。一旦子 goroutine panic 且未被 recover,它立即退出,但它的子 goroutine(如果已启动)仍持有原 ctx 引用 —— 只要父 ctx 没取消,这些“孤儿 goroutine”就继续跑,既不响应取消,也不释放资源。
例如:
- 主 goroutine 启动一个日志上传 goroutine,传入
ctx - 主 goroutine panic,退出,但日志 goroutine 仍在
select { case 中等待 - 此时 ctx 未取消,它就一直阻塞或继续发请求,内存和连接全卡住
关键点:
- 所有启动子 goroutine 的地方,都要考虑 panic 传播路径;必要时加
defer func(){if r:=recover();r!=nil{...}}() - 不要假设“父 goroutine 退出 = 子自动停”,必须显式设计终止协作机制
- 对关键子 goroutine(如网络 IO、文件写入),建议封装为可关闭结构体,提供
Close()方法统一 cancel + wait
WithValue 混入取消链,掩盖真正的生命周期信号
context.WithValue 语义是只传数据,不参与取消。但常有人把它当“增强版配置”用,比如把 shouldRetry bool 塞进 value,然后在 goroutine 里只读这个值做判断,完全忽略 ctx.Err()。结果就是:父 ctx 已超时取消,但子 goroutine 还在按 value 里的旧配置重试,越重试越占内存。
真实风险:
- value 是静态快照,无法反映 ctx 状态变化(
Done()、Err()是动态的) - 混用
WithValue和取消逻辑,会让取消行为变得不可预测、难调试 - pprof 常看到大量 goroutine 停在
runtime.chanrecv,背后正是这类“只看 value、不听 ctx”的死循环
记住一条铁律:
-
WithValue只用于传递**请求范围内的不可变元数据**(如 traceID、userRole) - 任何涉及“是否继续”“是否重试”“是否超时”的判断,必须直接检查
ctx.Err()或监听ctx.Done() - 禁止把
WithValue当作取消开关的替代品
真正难防的不是某一行写错,而是整个控制流里没有形成“监听 → 清理 → 退出”的闭环。哪怕 ctx 正确传递了,只要中间某层 goroutine 忘了在循环开头加 if ctx.Err() != nil { return },或者忘了 close channel、cancel timer、释放 buffer,泄漏就已发生。











