WithTimeout 的 cancel，不是你想象的那个“超时按钮”

Tue, 26 May 2026 15:30:00 +0800

接口已经超时了，goroutine 曲线还在往上爬。

上篇讲到这里时，我们先压住了一个误判：这通常不是 context 没生效，而是你的 goroutine 没有响应取消信号。

但还有一个更隐蔽的问题，很多 Go 代码每天都在写：

1
2


ctx, cancel := context.WithTimeout(parent, 200*time.Millisecond)
defer cancel()

这句 defer cancel() 到底是干什么的？

很多人心里其实把它理解成“超时按钮”。好像 cancel 是用来触发 timeout 的；既然 timeout 到点会自动发生，那函数里忘了调也没什么大不了。

这个理解只差一步，但差的正是事故里最贵的一步。

WithTimeout 的 cancel 不是超时按钮，是资源释放按钮。

时间到了，标准库会取消这个 context；但你的函数提前返回时，标准库不知道你这条调用链已经没用了。你不主动 cancel，它就只能等 deadline 到，或者等父 context 被取消。

这不是语法洁癖，是生命周期设计。

timeout 会自动发生，不等于你可以不收尾

先把 WithTimeout 看薄一点。

Go 标准库里，WithTimeout(parent, d) 本质上就是：

1

context.WithDeadline(parent, time.Now().Add(d))

它创建的是一个带 timer 的子 context。deadline 到了，timer 触发，context 的 Done 会关闭，Err() 会变成 context deadline exceeded。