Go 的 http.Client 超时必须显式设置，零值表示无限等待，易致 goroutine 泄漏；推荐使用 Client.Timeout 一键控制整个请求生命周期，覆盖连接、重定向及响应体读取，并用 errors.Is(err, context.DeadlineExceeded) 判断超时。
Go 的 http.Client 超时必须显式设置，零值不安全
Go 标准库的 http.Client 默认没有超时限制，Timeout 字段为 0 表示“无限等待”。这在生产环境极易引发 goroutine 泄漏和连接堆积。必须手动配置超时，且推荐用 http.Client{Timeout: ...} 一键控制整体请求生命周期，而非只设底层连接或读写超时。
http.Client.Timeout 控制整个请求周期，覆盖连接、重定向、读响应体
该字段从发起请求开始计时，到 Response.Body 关闭（或被丢弃）为止。它比单独设置 Transport 中的 DialContext、ResponseHeaderTimeout 等更简洁可靠。
- 适用于大多数 HTTP 请求场景，包括 GET/POST、JSON API 调用、文件上传（需注意大文件上传可能触发超时）
- 若设为
30 * time.Second，则 DNS 解析、TCP 握手、TLS 握手、发送请求、接收响应头、读取全部响应体都必须在此时间内完成 - 超时后会自动关闭底层连接，释放 goroutine，不会留下悬挂的
net.Conn
client := &http.Client{
Timeout: 15 * time.Second,
}
resp, err := client.Get("https://api.example.com/data")
if err != nil {
// 可能是 net/http: request canceled (Client.Timeout exceeded)
return
}
defer resp.Body.Close()需要精细控制时才拆分 Transport 超时参数
仅当有特殊需求才绕过 Timeout，例如：允许长连接但限制握手时间，或容忍慢响应头但禁止慢响应体。此时需自定义 http.Transport，注意各超时字段作用范围：
-
DialContext：控制 DNS 解析 + TCP 连接建立耗时 -
TLSHandshakeTimeout：仅 TLS 握手阶段 -
ResponseHeaderTimeout：从发出请求到收到响应头（Status和 headers）的时间 -
ExpectContinueTimeout：对Expect: 100-continue的等待上限 -
IdleConnTimeout和KeepAlive：影响连接复用，与单次请求超时不直接相关
⚠️ 常见错误：只设 DialContext 却忽略 ResponseHeaderTimeout，导致服务端卡在生成响应头时客户端无限等待。
立即学习“go语言免费学习笔记（深入）”；
超时错误类型判断要区分 url.Error 和上下文取消
超时错误不是简单的 err != nil 就能处理。实际返回的是 *url.Error，其 Err 字段可能是：
-
net/http: request canceled：由context.WithTimeout或Client.Timeout触发 -
net/http: request canceled while waiting for connection：卡在连接池排队 -
net/http: request canceled (Client.Timeout exceeded while awaiting headers)：响应头未及时到达
建议用 errors.Is(err, context.DeadlineExceeded) 判断是否为超时，而不是字符串匹配——因为 Go 1.20+ 已将超时错误包装为上下文错误。
ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
req, _ := http.NewRequestWithContext(ctx, "GET", "https://slow.example.com", nil)
resp, err := client.Do(req)
if err != nil {
if errors.Is(err, context.DeadlineExceeded) {
log.Println("request timed out")
}
}Go 的 HTTP 超时控制关键在于：别依赖默认值，优先用 Client.Timeout；真要拆解时，务必理解每个 Transport 字段的实际生效边界；捕获错误时用标准库提供的 errors.Is 检测，而不是硬判字符串。
