Go语言如何用context设置超时_Go语言context超时控制教程【收藏】-Golang-PHP中文网

context.WithTimeout 无效果是因为未将 ctx 传入下游函数或函数未监听 ctx.Done()；超时后 ctx.Err() 返回 context.DeadlineExceeded，应使用 errors.Is(err, context.DeadlineExceeded) 判断。

go语言如何用context设置超时_go语言context超时控制教程【收藏】

Go 里用 context.WithTimeout 设置超时，不是“加个 context 就自动超时”，必须显式传给下游函数，且该函数得真正检查 ctx.Done() —— 否则超时纯属摆设。

为什么 `context.WithTimeout` 调用了却没效果？

常见错误是只创建了带超时的 ctx，但没把它传进实际执行 IO 或计算的函数里。比如调用 http.Client.Do 时不传 ctx，或自己写的数据库查询函数压根不接收 ctx 参数。

关键点：

context 本身不中断任何 goroutine，它只是提供一个信号通道（ctx.Done()）
所有可能阻塞的操作，必须主动监听 ctx.Done() 并退出
标准库中如 http.Client、sql.DB.QueryContext 等才支持 context；裸写 time.Sleep 或循环不检查 ctx，就完全无视超时

`WithTimeout` 和 `WithDeadline` 该怎么选？

两者本质一样：WithTimeout 是基于当前时间 + 持续时间算出 deadline，WithDeadline 直接指定绝对时间点。选哪个取决于你控制超时的粒度。

使用建议：

对外部 API 调用、用户请求处理，用 WithTimeout 更自然（比如“最多等 5 秒”）
需要和外部系统对齐截止时间（如分布式任务协调），用 WithDeadline 避免本地时钟漂移影响
注意：两个函数返回的 ctx 都要配合 defer cancel()，否则可能泄漏 timer

超时后 `ctx.Err()` 返回什么？怎么判断？

超时触发后，ctx.Err() 返回 context.DeadlineExceeded，这是一个预定义的 error，不是字符串匹配。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本官方下载，版本号 1.26.0，适合旧项目维护、兼容性测试和指定版本开发环境搭建。

下载

正确判断方式：

用 errors.Is(err, context.DeadlineExceeded)（推荐，兼容 future 变更）
或直接比较 err == context.DeadlineExceeded（当前安全，但不如 errors.Is 健壮）
不要用 strings.Contains(err.Error(), "timeout") —— 错误信息可能变，且非所有 timeout error 都含 timeout 字样

示例：

ctx, cancel := context.WithTimeout(context.Background(), 2*time.Second)
defer cancel()
select {
case <h3>自定义函数怎么真正支持 context 超时？</h3><p>如果你写了一个可能阻塞的函数（比如轮询状态、重试逻辑），想让它响应 context 超时，就得在循环或等待点插入检查。</p><p>实操要点：</p>

函数签名必须接收 ctx context.Context 参数
每次进入可能阻塞前（如 time.Sleep、ch 、<code>db.QueryRowContext），先 select 判断 ctx.Done()
不要把 ctx 存到结构体长期持有——容易忘记 cancel，或导致生命周期混乱
如果内部启了 goroutine，记得用 ctx 派生子 context（如 childCtx, _ := context.WithCancel(ctx)），并在 goroutine 结束时 cancel