搭建Golang环境并排查网络超时问题-Golang-PHP中文网

go默认http客户端无超时，http.defaultclient.timeout为零值，导致dns解析、tcp连接等阶段无限等待；必须分阶段配置net.dialer.timeout、tlshandshaketimeout、responseheadertimeout等，并用errors.is(err, context.deadlineexceeded)或net.error.timeout()判断超时。

搭建golang环境并排查网络超时问题

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，属于临时性错误，适合重试