Go context.WithCancel 不调用 cancel 为什么会泄漏
来源:17golang原创
时间:2026-09-07 07:18:10 367浏览 收藏
会。更准确地说,context.WithCancel 返回的 cancel 如果一直不调用,子 context 可能继续挂在父 context 上;如果还有 goroutine 等待它的 Done(),这些 goroutine 也不会因为调用方已经返回而自动结束。它不是“每漏一次就立刻内存暴涨”,但在循环创建、长生命周期父 context 或后台 worker 场景中,确实会变成可观测的资源泄漏。
创建方拥有取消责任:子操作完成、失败或提前退出时都调用cancel;而 goroutine 是否能结束,还取决于它是否真的监听ctx.Done()。
cancel会关闭子 context 的取消信号,并解除父子关联;WithCancel没有超时定时器,但仍有清理责任。- 最稳妥的模式是创建后立刻
defer cancel(),再把子 context 传给下游。 - 排查泄漏要同时看 context 生命周期、等待
Done的 goroutine 和未关闭的业务资源。
为什么不调用 cancel 会让子 context 活得太久
WithCancel(parent) 建立的是一棵取消树。父节点会知道自己的子节点,子节点也持有父节点;调用 cancel 后,子节点的 Done 被关闭,父节点对它的关联被移除,后代也收到取消信号。只要父 context 仍然长存,忘记取消的子节点就可能比一次请求、一次任务需要的时间更久。
因此要区分两个现象:只忘记 cancel,通常先是 context 关联和相关对象延迟释放;如果下游启动的 goroutine 只等 ctx.Done(),它会一直阻塞,才形成典型的 goroutine 泄漏。WithCancel 本身不像 WithTimeout 那样新增一个定时器,但这不代表可以省略取消。

创建后立刻安排 cancel,覆盖所有返回路径
取消责任应该放在创建子 context 的函数里,而不是交给某个不清楚生命周期的下游函数。只要后续代码不需要提前保留它,创建后马上安排 defer cancel(),正常返回、错误返回和中途校验失败都会执行。
func loadProfile(parent context.Context, id string) (Profile, error) {
// 创建方拥有子 context 的生命周期,先登记兜底清理。
ctx, cancel := context.WithCancel(parent)
defer cancel()
// 下游必须接收同一个 ctx,才能感知上游的取消。
profile, err := queryProfile(ctx, id)
if err != nil {
return Profile{}, err
}
return profile, nil
}
这里的 defer 不是为了“等垃圾回收”,而是明确告诉调用链:loadProfile 结束后,子 context 不再有用。若函数把 cancel 返回给调用方,则必须把责任写进接口约定,并确保每个调用方都执行;对请求处理函数来说,局部 defer 往往更不容易漏。
只有 cancel 还不够,worker 必须有退出分支
常见误区是创建了可取消 context,却启动一个没有读取 Done 的 goroutine。这样的 goroutine 不会因 cancel 自动消失。生产代码应让每个长期运行的循环都拥有明确的停止条件,并在输入 channel 关闭时结束。
func startWorker(parent context.Context, jobs
调用方要在任务完成、失败或被替换时调用返回的函数;如果 worker 只是请求级 goroutine,则可以直接把请求 context 传入,并由请求边界负责取消。不要用 context.Background() 在下游重新开一棵树,否则上游的取消信号无法传到 worker。

用这张清单判断是不是 context 泄漏
| 观察点 | 应有的关系 | 异常信号 |
|---|---|---|
| 创建位置 | 创建后马上登记 cancel | 函数有多个 return,却找不到统一清理 |
| 取消传播 | 下游 API 接收同一个 ctx | 下游重新使用 Background |
| goroutine 退出 | 循环 select 包含 ctx.Done | 只等业务 channel,永远没有停止条件 |
| 资源释放 | rows、连接、文件等各自关闭 | 把 cancel 当成所有资源的 Close |
排查时可以先用 goroutine profile 看数量是否随请求增长,再沿 goroutine 堆栈找到阻塞 channel 或等待条件;同时检查创建子 context 的代码路径。调用 cancel 只能解除 context 关联并广播取消,不能替代 rows.Close()、文件关闭或业务队列确认。
相关问题
WithCancel 不调用 cancel 一定会内存泄漏吗?
不一定立刻表现为堆内存持续上升,但它会让子 context 及其后代延迟结束;父 context 越长寿、创建次数越多,风险越明显。
父 context 结束后还需要调用 cancel 吗?
仍建议调用。父节点取消会传播到子节点,但创建方保留 defer cancel() 能覆盖父节点未取消、提前返回和未来改造后的路径。
cancel 能关闭业务 channel 吗?
不能。它只发送 context 的取消信号;业务 channel、数据库结果集和文件仍由各自的所有者关闭。
-
Golang · Go问答 | 15分钟前 | ResponseWriter · Go问答 · HTTP响应 · 请求排障 · Go WriteHeader http.ResponseWriter HTTP Header424 收藏
-
Golang · Go问答 | 26分钟前 | net/http · Go问答 · HTTP超时 · 服务端配置 · Go http.server WriteTimeout ReadHeaderTimeout IdleTimeout266 收藏
-
499 收藏
-
489 收藏
-
170 收藏
-
492 收藏
-
480 收藏
-
144 收藏
-
115 收藏
-
453 收藏
-
291 收藏
-
386 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习