背景

总超时只说明整个请求最多等多久,不会解释慢在连接、TLS 还是响应体。分层超时让故障路径更可控。

核心判断

  1. 分别设置拨号、TLS 握手、响应头与请求总预算。
  2. 复用 Transport 与连接池,不为每个请求重建。
  3. 流式下载单独设计读取期限,不盲目沿用短总超时。

最小示例

下面保留核心逻辑;业务类型、调用入口和环境配置按项目补齐。

transport := http.DefaultTransport.(*http.Transport).Clone()
transport.DialContext = (&net.Dialer{
    Timeout:   2 * time.Second,
    KeepAlive: 30 * time.Second,
}).DialContext
transport.TLSHandshakeTimeout = 2 * time.Second
transport.ResponseHeaderTimeout = 3 * time.Second
transport.IdleConnTimeout = 60 * time.Second

client := &http.Client{
    Transport: transport,
    Timeout:   8 * time.Second,
}

边界与误区

IdleConnTimeout 管空闲连接,不是响应体读取时限。Client.Timeout 包含读取 body 的整体预算;克隆默认 Transport 可保留重要默认设置。

验证方式

让测试服务器分别延迟响应头与 body,验证错误与耗时。长连接和流式接口按独立场景回归,确认取消后资源能回收。

小结

分别设置连接、TLS、响应头、空闲连接和请求总 deadline。