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。

go
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)
}

预期输出

text
repository: stop
handler: context deadline exceeded

即使使用了超时上下文,也应调用返回的 cancel。defer cancel() 会释放与该上下文关联的计时器等资源;如果函数会长期运行,不要把取消动作遗漏到进程退出时才处理。

在调用链中只向下传递

约定把 context.Context 放在函数参数的第一位,并命名为 ctx。例如业务层接收请求上下文后,把它原样传给仓储层;仓储层只有在需要更短超时时才继续派生子上下文。

不要在普通业务对象中长期保存 Context,也不要为了方便在深层函数重新使用 context.Background()。后一种做法会切断取消链:上游已经超时,下游数据库查询或 goroutine 仍可能继续执行。

context 取消信号沿调用链向下传播

如果某一层只允许额外执行 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 请求等下游操作接受同一个上下文,这样取消才能真正截断昂贵工作,而不是只让最外层函数提前返回。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 context 传播取消信号

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通