Go默认HTTP客户端无超时，http.DefaultClient.Timeout为零值，导致DNS解析、TCP连接等阶段无限等待；必须分阶段配置net.Dialer.Timeout、TLSHandshakeTimeout、ResponseHeaderTimeout等，并用errors.Is(err, context.DeadlineExceeded)或net.Error.Timeout()判断超时。
Go 默认 HTTP 客户端根本没超时，别信它
刚写完 http.Get("https://api.example.com") 就卡住？不是网络问题，是 http.DefaultClient 的 Timeout 字段为 0 —— 意味着无限等待。Linux 下可能卡在 net.(*pollDesc).wait 几分钟，直到内核重试耗尽（tcp_syn_retries 默认 6 次，约 130 秒）。这不是 bug，是 Go 的设计哲学：你必须明确声明“我愿意等多久”。不设超时，等于把命运交给 DNS、防火墙、SYN 丢包和 TLS 握手失败。
-
http.DefaultClient和未配置的*http.Client实例默认无任何超时 - 仅靠
Client.Timeout是粗粒度总闸，会覆盖所有阶段，容易误杀慢但合法的响应 - 真正卡死的根源在连接建立阶段，而
Client.Timeout对Dial阶段无效 —— 必须用net.Dialer.Timeout -
net.DialTimeout已废弃（Go 1.17+），必须改用&net.Dialer{Timeout: 5 * time.Second}
HTTP 客户端超时必须分层配，不能只设一个 Timeout
生产环境里，一次 HTTP 请求包含多个可独立失败的阶段：DNS 解析 → TCP 连接 → TLS 握手 → 发送请求 → 等待响应头 → 读取响应体。把它们混在一个 Client.Timeout 里，要么太短导致误判，要么太长失去保护意义。
-
DialContext：用&net.Dialer{Timeout: 3 * time.Second}控制 TCP 连接建立上限（推荐 3–5 秒） -
TLSHandshakeTimeout：HTTPS 必设，建议 ≤ 5 秒；若不设，TLS 协商卡住会拖垮整个请求 -
ResponseHeaderTimeout：从连接建立完成到收到第一个字节（Status Line）的时间，防服务端“开了连接却不发响应” -
IdleConnTimeout和MaxIdleConnsPerHost要配套调，否则连接池空闲连接不释放，fd 泄漏 -
Client.Timeout应大于各阶段之和（例如：3 + 5 + 5 = 13 秒 → 设为 15 秒），否则会被提前中断
怎么判断真是超时，而不是其他网络错误
别用 strings.Contains(err.Error(), "timeout") —— 不跨平台、不可靠、易被日志污染。Go 标准库所有底层网络错误都实现了 net.Error 接口，唯一可信方式是类型断言加 Timeout() 方法。
- 正确写法：
if ne, ok := err.(net.Error); ok && ne.Timeout() { ... } -
Temporary()可辅助判断是否值得重试（超时必Temporary() == true，但Temporary()不一定超时） - HTTP 客户端返回的
err多数是*url.Error，需先解包：if urlErr, ok := err.(*url.Error); ok { if ne, ok := urlErr.Err.(net.Error); ok && ne.Timeout() { ... } } - DNS 解析失败（
lookup xxx: no such host）不是超时，Timeout()返回 false，属于临时性错误，适合重试
重试不能无脑 for 循环，得看超时发生在哪一环
同样是超时，处理策略天差地别：连接阶段超时说明服务不可达或网络不通，读超时可能是服务响应慢或中间链路抖动。盲目重试可能雪崩，尤其在高并发下。
- 连接超时（
DialContext阶段）：适合立即重试，建议指数退避（初始 100ms，翻倍，上限 5s），最多 3–5 次 - 读超时（
ResponseHeaderTimeout或SetReadDeadline）：若请求幂等（如 GET），可重试；否则应放弃并报错 - 写超时极少发生，通常意味着对端崩溃或网关异常，应关闭连接重建，而非重发原始数据
- 永远在重试前调用
conn.Close()或确保旧http.Response.Body已Close()，否则 fd 泄漏 - 不要在
http.Client层面自己实现重试 —— 它已内置连接复用和部分重试逻辑；重试应放在业务封装层
真正容易被忽略的是：超时配置必须和你的服务 SLA 对齐。比如你承诺用户 99% 请求在 2 秒内返回，那 ResponseHeaderTimeout 就不该设成 5 秒 —— 它直接决定了你能否兑现承诺。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
