Go / 系统课时
用 context 传播取消信号
用 context 传播取消信号
当请求超时、用户取消操作或上游决定放弃任务时,下游函数和后台 goroutine 也应尽快停止。本课用 context.Context 建立一条可取消的调用链,并让阻塞中的工作在截止时间到达后及时返回。
学习目标
- 使用
context.WithCancel、context.WithTimeout和context.WithDeadline派生可取消上下文。 - 把同一个
Context沿函数调用链向下传递,并用Done响应取消。 - 根据
context.Canceled与context.DeadlineExceeded判断任务停止原因。
从调用入口建立可取消上下文
context.Background() 通常作为进程级根上下文;真正执行一次请求或任务时,再从它派生子上下文。context.WithCancel 适合由业务逻辑主动停止任务,context.WithTimeout 适合限制最长执行时间,context.WithDeadline 则接受一个绝对截止时间。
下面把一次操作限制为 50 毫秒,而仓储函数模拟需要 200 毫秒才能完成的工作。handleRequest 不创建新的根上下文,只把收到的 ctx 继续传给 loadProfile。
package main
import (
"context"
"fmt"
"time"
)
func loadProfile(ctx context.Context) error {
select {
case <-time.After(200 * time.Millisecond):
fmt.Println("repository: completed")
return nil
case <-ctx.Done():
// 下游直接返回父级取消或超时产生的错误。
fmt.Println("repository: stop")
return ctx.Err()
}
}
func handleRequest(ctx context.Context) error {
return loadProfile(ctx)
}
func main() {
ctx, cancel := context.WithTimeout(context.Background(), 50*time.Millisecond)
defer cancel()
err := handleRequest(ctx)
fmt.Println("handler:", err)
}预期输出
repository: stop
handler: context deadline exceeded即使使用了超时上下文,也应调用返回的 cancel。defer cancel() 会释放与该上下文关联的计时器等资源;如果函数会长期运行,不要把取消动作遗漏到进程退出时才处理。
在调用链中只向下传递
约定把 context.Context 放在函数参数的第一位,并命名为 ctx。例如业务层接收请求上下文后,把它原样传给仓储层;仓储层只有在需要更短超时时才继续派生子上下文。
不要在普通业务对象中长期保存 Context,也不要为了方便在深层函数重新使用 context.Background()。后一种做法会切断取消链:上游已经超时,下游数据库查询或 goroutine 仍可能继续执行。

如果某一层只允许额外执行 300 毫秒,可以从收到的 ctx 派生 context.WithTimeout(ctx, 300*time.Millisecond)。父级先取消时,子级立即收到信号;子级自己的 300 毫秒先到时,只结束该子树,不会反向取消父级。
让 goroutine 主动监听 Done
Context 不会强制终止 goroutine。真正停止工作的是 goroutine 自己,因此可能阻塞较久的循环、通道等待或外部调用,都要提供观察 ctx.Done() 的机会。前面的 select 就把“工作完成”和“上下文结束”放在同一等待点。
对于持续循环的 worker,可以在每轮处理前检查一次 ctx.Err(),并在等待通道、计时器或网络结果时把 <-ctx.Done() 放入 select。如果一轮工作本身可能耗时数秒,还需要把 ctx 继续交给支持上下文的 API,而不能只在循环入口检查一次。
区分主动取消与截止时间
三种常用派生方式的差异可以直接从结束条件判断:
| API | 结束条件 | ctx.Err() |
|---|---|---|
context.WithCancel |
调用返回的 cancel() |
context.Canceled |
context.WithTimeout |
超过指定持续时间,或提前调用 cancel() |
context.DeadlineExceeded 或 context.Canceled |
context.WithDeadline |
到达指定 time.Time,或提前调用 cancel() |
context.DeadlineExceeded 或 context.Canceled |
处理错误时不要依赖错误文本。需要区分超时和主动取消时,可用 errors.Is(err, context.DeadlineExceeded) 或 errors.Is(err, context.Canceled) 判断。生产代码还应让数据库、HTTP 请求等下游操作接受同一个上下文,这样取消才能真正截断昂贵工作,而不是只让最外层函数提前返回。