背景
总超时只说明整个请求最多等多久,不会解释慢在连接、TLS 还是响应体。分层超时让故障路径更可控。
核心判断
- 分别设置拨号、TLS 握手、响应头与请求总预算。
- 复用 Transport 与连接池,不为每个请求重建。
- 流式下载单独设计读取期限,不盲目沿用短总超时。
最小示例
下面保留核心逻辑;业务类型、调用入口和环境配置按项目补齐。
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。