Go 请求设置 Context 超时后为什么连接还没马上消失

我在排查 Go HTTP 调用超时时，最容易被一行日志带偏：context deadline exceeded 已经返回了，但连接监控里短时间仍能看到旧连接，服务端日志也可能稍后才结束。这里的关键是，Context 超时先取消的是这次请求的生命周期；它不承诺客户端指标、连接池状态和服务端 goroutine 在同一个时刻归零。

正确做法是先确认 Context 是否传进了请求，再关闭响应体并复用 Transport；如果要让服务端尽快收尾，还要让服务端 handler 或下游操作主动监听它自己的 Context。

先分清：请求结束、连接结束和服务端结束不是一件事

一次出站请求至少经过三个边界：Go 客户端等待连接并发送数据，客户端读取响应，服务端执行 handler 或数据库调用。context.WithTimeout 关闭 Done 后，Client.Do 可以返回超时错误；但已经建立的 HTTP/1.1 keep-alive 连接可能作为空闲连接继续留在 Transport 中，HTTP/2 则可能继续复用同一条连接承载其他请求。

所以“连接还没马上消失”先不要直接当成泄漏。真正要问的是：它是仍在使用、已空闲可复用，还是服务端根本没有响应取消？这三个状态的处理方式完全不同。

把超时上下文传到真正发请求的那一层

如果上层创建了带超时的 Context，却在下层重新使用 context.Background()，或者先创建请求、后在另一处丢掉返回的新请求，取消信号就没有按预期传播。推荐在创建请求时直接绑定：

ctx, cancel := context.WithTimeout(context.Background(), 800*time.Millisecond)
defer cancel() // 及时释放定时器和子 Context 资源

req, err := http.NewRequestWithContext(ctx, http.MethodGet, endpoint, nil)
if err != nil {
    return err // URL 或方法不合法时，先返回构造错误
}

resp, err := client.Do(req)
if err != nil {
    if errors.Is(err, context.DeadlineExceeded) {
        return fmt.Errorf("请求超时: %w", err) // 只把超时归到超时分支
    }
    return err // 连接失败、TLS 失败等保留原始错误链
}
defer resp.Body.Close() // 读完或放弃读取都要关闭响应体

_, err = io.Copy(io.Discard, resp.Body) // 示例只关心请求能否完整读完
return err

WithContext 返回的是带新 Context 的请求副本，不能指望调用它后原来的 req 自动改变。对出站请求而言，官方文档明确把上下文范围延伸到获取连接、发送请求以及读取响应头和响应体；因此应当在实际调用 client.Do 的请求对象上检查 req.Context()。

响应体和 Transport 决定“连接还在”是否正常

HTTP 客户端为了复用连接，会把完成请求后的连接放回 Transport 管理。拿到响应后不关闭 resp.Body，会让资源回收和连接复用行为变得不可预测；但关闭响应体也不表示底层 TCP 连接必须立刻销毁，它可能已经回到 keep-alive 空闲池。

client.CloseIdleConnections() 只关闭已经处于空闲 keep-alive 状态的连接，不会打断正在使用的连接。它适合测试或明确的生命周期切换，不适合作为每次超时后的“清理按钮”。生产代码更应复用一个长期存在的 http.Client 和 Transport，再结合连接指标判断状态。

HTTP/1.1、HTTP/2 和服务端取消要分别看

HTTP/1.1 常见的是一条 TCP 连接承载请求后进入 keep-alive；HTTP/2 则把多个请求复用在连接和流的不同层次。客户端 Context 超时后，当前请求不再继续等待，但不能据此推断整条 HTTP/2 连接都关闭。更不能用已弃用的 Transport.CancelRequest 作为新代码方案：官方文档说明它不能取消 HTTP/2 请求。

如果服务端 handler 还在做慢查询、远程调用或文件处理，服务端代码必须把 r.Context() 继续传给下游，并在循环或阻塞点响应 ctx.Done()。否则客户端已经超时，服务端仍可能把工作做完，这不是客户端 Context 失效，而是取消信号没有贯穿服务端任务。

func handler(w http.ResponseWriter, r *http.Request) {
    ctx := r.Context() // 请求断开或 HTTP/2 取消时，服务端 Context 会变化
    if err := slowStore(ctx); err != nil {
        if errors.Is(err, context.Canceled) {
            return // 客户端已放弃，避免继续写无意义的响应
        }
        http.Error(w, "internal error", http.StatusInternalServerError)
        return
    }
    w.WriteHeader(http.StatusNoContent)
}

用错误链和分阶段日志验证，而不是盯着一条连接

最小排查记录至少带上请求 ID、开始时间、错误、协议和服务端完成时间。客户端用 errors.Is 判断 context.DeadlineExceeded 或 context.Canceled，不要只比较错误字符串；同时记录请求是否已经拿到响应头、响应体是否关闭。这样才能知道超时发生在等待连接、写请求还是读响应。

如果客户端错误已稳定归为超时，响应体也按约关闭，而服务端完成时间明显晚于客户端返回，那么下一步应该查服务端下游是否使用了 r.Context()，而不是反复增大客户端超时或销毁整个 Transport。

常见问题

Context 超时后必须调用 CloseIdleConnections 吗？

不必须。它只处理空闲连接，不能终止正在使用的请求；频繁调用还会削弱连接复用。先关闭响应体并确认是否真有空闲连接积压。

客户端返回超时，服务端一定收到了取消信号吗？

不一定。客户端取消和服务端停止工作是两个边界，服务端必须把请求 Context 传给数据库、RPC 或循环，并主动处理取消。

为什么错误不是直接等于 context.DeadlineExceeded？

网络库通常会包装错误。使用 errors.Is(err, context.DeadlineExceeded) 才能可靠识别超时，同时保留原始错误链用于日志。

来源依据

• Go net/http Request、NewRequestWithContext 与 Transport 文档：https://pkg.go.dev/net/http
• Go context 包文档：https://pkg.go.dev/context
• Go 官方 Transport 源码：https://go.dev/src/net/http/transport.go