Golang如何使用context控制任务超时

在Go语言中，context用于控制任务生命周期，通过context.WithTimeout可创建带超时的上下文，如3秒后自动取消，需调用cancel释放资源；函数内使用select监听ctx.Done()以响应超时并及时返回错误。

在Go语言中，context 是控制任务生命周期的核心工具，尤其适用于处理超时、取消和传递请求范围数据。当你希望限制某个操作的执行时间，比如网络请求、数据库查询或后台任务，使用 context 实现超时控制是标准做法。

创建带超时的 Context

通过 context.WithTimeout 可以创建一个会在指定时间后自动取消的 context。它返回派生的 context 和一个 cancel 函数，后者必须调用以释放资源。

示例：

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel() // 确保释放资源
result, err := doSomething(ctx)
if err != nil {
log.Printf("操作失败: %v", err)
}

上面代码中，如果 doSomething 在3秒内未完成，context 会自动触发取消信号。

立即学习“go语言免费学习笔记（深入）”；

在函数中监听 Context 超时

被调用的函数需要持续检查 context 的状态，一旦超时或被取消，应立即停止工作并返回错误。

典型模式：

<code>func doSomething(ctx context.Context) (string, error) {
select {
case result := <-slowOperation():
return result, nil
case <-ctx.Done():
return "", ctx.Err()
}
}

这里使用 select 监听两个通道：一个是实际操作的结果，另一个是 context 的取消通知。当 context 超时时，ctx.Done() 通道会关闭，ctx.Err() 返回具体的错误（如 context.DeadlineExceeded）。

HTTP 请求中的超时控制

在发起 HTTP 请求时，也可以将 context 传入，实现对请求全过程的超时控制。

ctx, cancel := context.WithTimeout(context.Background(), 500*time.Millisecond)
defer cancel()
req, _ := http.NewRequest("GET", "https://example.com", nil)
req = req.WithContext(ctx)
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
log.Printf("请求失败: %v", err)
return
}
defer resp.Body.Close()

这样即使 DNS 解析、连接、传输等任一阶段耗时过长，都会在500毫秒后中断。

关键注意事项

• 始终调用 cancel() 函数，防止 context 泄漏
• 超时时间应根据业务场景合理设置，太短可能导致误失败，太长影响响应性
• context 不可用于传递可选参数，仅用于控制和元数据传递
• 链式调用中，下游函数也应接收并使用 context

基本上就这些。只要在可能阻塞的操作中监听 context 的取消信号，就能有效实现超时控制。不复杂但容易忽略细节，尤其是 cancel 的调用。