Go Academy · 课时

WithCancel 与 WithTimeout

Q: 「WithCancel 与 WithTimeout」这节课中我会学到什么？

创建可取消且带时间限制的上下文 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

创建可取消且带时间限制的上下文

第 2 / 4 课13 个步骤

WithCancel 与 WithTimeout 是 CoddyKit 上的免费 Go Academy 课时。这是第 2 节课，共 4 节。你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。

context.WithCancel

WithCancel 会派生一个带有取消函数的新上下文。调用 cancel 会关闭派生上下文及其所有子上下文的 Done 通道。

ctx, cancel := context.WithCancel(parent)
defer cancel() // always call to release resources
go doWork(ctx)

始终 defer cancel

不调用 cancel 会泄漏用于监视父上下文的协程。创建可取消的上下文后，请始终立即 defer cancel。

context.WithTimeout

WithTimeout 会派生一个在给定时长后自动取消的上下文。它是 WithDeadline 的便捷封装。

ctx, cancel := context.WithTimeout(parent, 5*time.Second)
defer cancel()
if err := db.QueryContext(ctx, query); err != nil {
    // err may be context.DeadlineExceeded
}

检查 Err()

Done 关闭后，ctx.Err() 会返回原因：context.Canceled（显式取消）或 context.DeadlineExceeded（超时）。

if err := ctx.Err(); errors.Is(err, context.DeadlineExceeded) {
    log.Println("timeout")
}

从另一个协程取消

取消函数可以安全地从任意协程调用，也可以由多个协程同时调用。只有第一次调用会产生效果。

ctx, cancel := context.WithCancel(context.Background())
go func() {
    if detectError() { cancel() }
}()

HTTP 请求超时

请在传入请求的上下文上使用 WithTimeout，为每个请求设置超时时间：

func handler(w http.ResponseWriter, r *http.Request) {
    ctx, cancel := context.WithTimeout(r.Context(), 2*time.Second)
    defer cancel()
    result, err := service.Call(ctx)
    // ...
}

级联取消

如果父上下文被取消，所有派生上下文（子上下文、孙上下文）都会自动被取消，从而停止调用树中的所有协程。

测试中的 Context

在测试中使用 context.Background() 或 context.WithTimeout，确保测试启动的协程会在限定时间内结束。

ctx, cancel := context.WithTimeout(context.Background(), 3*time.Second)
defer cancel()
testResult := runTest(ctx)

通过库传播 Context

始终将接收到的上下文传递给传出的调用（数据库查询、HTTP 调用、RPC）。除非有特定理由要重置截止时间，否则绝不要丢弃或替换它。

为后台任务创建上下文

对于不依附于请求的后台任务，请使用 context.Background() 作为根上下文，并添加一个 WithCancel，以便优雅地停止任务。

使用 Done 的 select

始终在工作通道旁通过 select 监听 ctx.Done()，避免上下文在工作完成前被取消时发生阻塞。

select {
case result := <-workCh:
    return result, nil
case <-ctx.Done():
    return nil, ctx.Err()
}

快速检查

context.WithCancel 和 context.WithTimeout 有什么区别？

在交互式课程中回答

回顾：WithCancel 与 WithTimeout

要点：

创建后始终立即 defer cancel()
WithTimeout 会在指定时长后自动取消；并返回 DeadlineExceeded
ctx.Err() 可以区分 Canceled 与 DeadlineExceeded
取消会传播到所有派生上下文

免费开始

用 AI 导师学习 Go — 免费

在浏览器中编写并运行真实代码，获得全天候 AI 导师的即时帮助，并在网页或应用中继续学习。

课程: 51
课程: 203

免费开始学习查看完整课程

常见问题解答

「WithCancel 与 WithTimeout」课时是免费的吗？

是的 — 「WithCancel 与 WithTimeout」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。

「WithCancel 与 WithTimeout」这节课中我会学到什么？

创建可取消且带时间限制的上下文你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 Go Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。这是第 2 节课，共 4 节。

「WithCancel 与 WithTimeout」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 Go Academy 课中编写并运行代码吗？

能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

← 返回 Go Academy