context是Go中控制协程生命周期和传递请求数据的核心机制,通过Done通道传递取消信号。2. 使用WithCancel、WithTimeout、WithDeadline创建可取消的上下文,需调用cancel避免泄漏。3. WithValue可附加请求范围的数据,所有派生context共享取消通知。

在Go语言中,context 是控制协程生命周期、传递请求范围数据以及处理取消信号的核心机制。它广泛应用于HTTP服务、数据库调用、超时控制等场景。理解 context 的语法和正确使用取消信号,是编写健壮并发程序的关键。
Context 基本语法与结构
context 包的核心是 Context 接口,包含四个方法:Deadline、Done、Err 和 Value。其中 Done 方法返回一个只读的 chan,用于监听取消信号。
创建 context 通常从两个根节点开始:
- context.Background():根 context,通常用于主函数或顶层请求
- context.TODO():占位 context,当不确定用哪种时使用
基于根 context,可以派生出带功能的子 context:
立即学习“go语言免费学习笔记(深入)”;
- context.WithCancel:返回可手动取消的 context
- context.WithTimeout:设置超时后自动取消
- context.WithDeadline:指定具体时间点取消
- context.WithValue:附加请求范围的键值对
取消信号的传递与监听
取消信号通过 channel 通知所有下游协程。一旦 context 被取消,其 Done channel 就会被关闭,监听该 channel 的 select 语句会立即触发。
常见模式如下:
ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel() // 避免泄漏
go func() {
select {
case <-ctx.Done():
fmt.Println("收到取消信号:", ctx.Err())
}
}()
关键点:
- 必须调用 cancel 函数释放资源,即使没提前取消
- ctx.Err() 可获取取消原因,如 context.Canceled 或 context.DeadlineExceeded
- 取消具有传播性,父 context 取消时,所有子 context 也会被取消
实际应用场景示例
在 HTTP 请求中控制超时:
client := &http.Client{}
req, _ := http.NewRequest("GET", "https://example.com", nil)
ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
req = req.WithContext(ctx)
resp, err := client.Do(req)
if err != nil {
log.Fatal(err)
}
在多阶段任务中协调取消:
ctx, cancel := context.WithCancel(context.Background()) defer cancel() go fetchUserData(ctx) go fetchConfig(ctx) // 某个条件触发取消 time.AfterFunc(1*time.Second, cancel)
每个子任务内部都应监听 ctx.Done() 并及时退出,避免 goroutine 泄漏。
注意事项与最佳实践
使用 context 时需注意以下几点:
- 不要将 context 存入结构体字段,而应作为函数第一个参数传入,通常命名为 ctx
- 不要传递 nil context,即使函数暂时不用也应传 context.Background()
- WithValue 仅用于传递元数据,如请求ID、认证token,不要传关键参数
- cancel 函数必须调用,建议使用 defer
- 避免 context 泄漏:长时间运行的 goroutine 若未收到取消信号会一直阻塞
基本上就这些。掌握 context 的取消机制,能有效提升程序的可控性和资源利用率。










