应使用 context.Background() 或 context.TODO() 创建不被父级取消的根 Context,二者均无父级、永不取消;避免误用 WithCancel/WithValue 基于非根 Context 派生,或在 HTTP handler 中复用 req.Context() 导致后台 goroutine 提前退出。

用 context.Background() 或 context.TODO() 创建无父级的根 Context
Go 中所有 context.Context 都是树状继承关系,只要父 context 被取消(CancelFunc() 调用或超时),所有子 context 就会同步进入 Done 状态。所以“不被父级取消”的本质,是**不从父 context 派生**,而是直接使用独立的根 context。
context.Background() 是最常用的选择,它返回一个空、永不取消、无 deadline、无 value 的 context,适用于主函数、初始化、HTTP 服务器入口等顶层场景;context.TODO() 语义上表示“此处本该有 context,但暂时没想好怎么传”,行为和 Background() 完全一致,仅作占位提示。
- 不要用
context.WithCancel(parent)后再忽略 parent 的 cancel —— 子 context 仍绑定父生命周期 - 避免误用
context.WithValue(context.Background(), ...):虽然它创建新 context,但仍是Background()的子节点,只是没带取消能力;它本身不会被取消,但这是“没继承取消能力”而非“隔离取消”,语义不清晰 - 若需携带值又不想关联任何取消逻辑,就用
context.WithValue(context.Background(), key, val),但注意这仍是根 context 的派生,不是问题所在
警惕 HTTP handler 中隐式继承的 req.Context()
HTTP server 中,每个请求的 *http.Request 自带 req.Context(),它由 server 内部创建,且与请求生命周期绑定:客户端断开、超时、server 关闭都会触发 cancel。很多人直接把 req.Context() 传给后台 goroutine,结果 goroutine 在请求结束后意外退出。
如果后台任务必须“活过请求”,就不能复用 req.Context(),而应切换为 context.Background():
// ❌ 错误:goroutine 受 HTTP 请求取消影响 go doWork(req.Context()) // ✅ 正确:脱离请求生命周期 go doWork(context.Background())
- 这种切换意味着你主动放弃对请求中断的响应能力,需自行处理超时/取消逻辑(如用
time.AfterFunc或独立context.WithTimeout) - 若任务需访问 request-scoped 值(如 auth token),不能靠
req.Context()传递,得显式提取后作为参数传入 - 某些中间件(如 OpenTelemetry 的 trace propagation)依赖
req.Context(),换用Background()会丢失 trace 上下文,需手动注入 span context
自定义取消逻辑时,别误以为 “不调用 cancel 函数” 就安全
有人试图绕过取消机制:保留父 context,但不调用其 CancelFunc,以为子 context 就不会被取消。这是错的 —— 只要父 context 因其他原因(如 deadline 到期、上游 cancel)结束,子 context 仍会立即收到通知。
真正可控的方式只有两种:
- 完全不继承:用
context.Background()或context.TODO() - 自己控制取消源头:用
context.WithCancel(context.Background()),然后只在你明确需要时调用返回的CancelFunc,这样取消权完全在你手里,与任何外部 context 无关
后者适合需要“可取消但不受父影响”的场景,例如启动一个长期运行的 worker,你希望它能被服务关闭信号终止,但不能被某个临时请求的取消波及。
为什么不用 context.WithTimeout(context.Background(), d)?
这个组合本身没问题,它创建的是以 Background() 为根、带超时的 context,不会受父 context 影响。但要注意:它的“不被父级取消”是成立的,可它的生命周期由自身 timeout 控制 —— 这和“永不过期”是两回事。
- 如果你要的是“绝对不取消”,那就不能设 deadline 或 timeout,只能用纯
Background() - 如果只是想摆脱父 cancel,但允许自身超时,
WithTimeout(context.Background(), ...)是正确选择 - 切勿写成
WithTimeout(parentCtx, d)并期望“忽略 parent 取消”——timeout context 仍是 parent 的子节点,parent 一 cancel,它立刻结束,deadline 根本没机会触发
真正容易被忽略的点是:Context 的“不可取消性”不是开关属性,而是继承关系决定的。只要路径里存在一个可取消的祖先,整条链就不可靠。断掉那条链,比修补链上的某个环节更彻底。

















