Go的http.Client必须分三段控制超时：Client.Timeout作总兜底，Transport.DialContext控DNS+TCP建连（建议5s），ResponseHeaderTimeout控响应头接收（建议8s）；仅设Client.Timeout无法防DNS、TLS或后端“半开”卡死。
设置 http.Client 的超时时间要分三段控制
Go 的 http.Client 默认不设超时，一次卡死就整个协程挂住。必须手动配置 Timeout、Transport 里的 DialContext 和 ResponseHeaderTimeout 才算真正防住各种卡点。
常见错误是只设 Client.Timeout，结果 DNS 解析卡住、TLS 握手卡住、或服务端迟迟不发响应头，依然无限等待。
-
Client.Timeout：整个请求生命周期上限（含 DNS、连接、TLS、发送、读响应体），适合兜底 -
Transport.DialContext：控制建连阶段（DNS + TCP 连接），建议设5s左右 -
Transport.ResponseHeaderTimeout：从发完请求到收到响应头的等待时间，防后端“已收但不回” - 不需要单独设
Transport.TLSHandshakeTimeout—— 它已被DialContext覆盖（Go 1.12+）
client := &http.Client{
Timeout: 10 * time.Second,
Transport: &http.Transport{
DialContext: func(ctx context.Context, network, addr string) (net.Conn, error) {
dialer := &net.Dialer{
Timeout: 5 * time.Second,
KeepAlive: 30 * time.Second,
}
return dialer.DialContext(ctx, network, addr)
},
ResponseHeaderTimeout: 8 * time.Second,
},
}用 http.ProxyURL 或自定义函数配代理最稳妥
代理不是所有请求都走，比如本地地址或私有网段通常绕过。Go 提供 http.ProxyURL 快速复用环境变量（HTTP_PROXY/HTTPS_PROXY/NO_PROXY），但注意它不解析 NO_PROXY 中的 CIDR，只支持逗号分隔的域名或 IP 字符串（如 "localhost,127.0.0.1,192.168.0.0/16" 里最后一项会被当字面量匹配，无效）。
更可靠的方式是写个闭包函数，显式判断是否跳过代理：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
proxyFunc := func(req *http.Request) (*url.URL, error) {
if strings.HasPrefix(req.URL.Host, "192.168.") || req.URL.Host == "localhost" {
return nil, nil // 不走代理
}
return url.Parse("http://127.0.0.1:8888")
}
client := &http.Client{
Transport: &http.Transport{
Proxy: proxyFunc,
},
}- 代理 URL 协议必须明确写
"http://"，即使目标是 HTTPS 站点 —— Go 会自动升级为 CONNECT 隧道 - 如果代理需要认证，把用户名密码塞进
url.User()，例如url.UserPassword("user", "pass") - 别用
http.ProxyFromEnvironment直接赋值给Transport.Proxy—— 它内部调用http.ProxyURL，同样受NO_PROXY解析缺陷影响
http.Transport 复用连接时，代理和超时配置必须绑定在 Transport 上
很多人把 Proxy 设在 Client 层，但实际起作用的是 Transport.Proxy；同理，Timeout 是 Client 级兜底，而连接池、TLS 设置、各类子超时全在 Transport 里。一旦你自定义了 Transport，就必须把代理和超时逻辑完整移到里面，否则会静默失效。
典型误用：
// ❌ 错误：Client.Proxy 不生效，且 Transport 没设超时
client := &http.Client{
Proxy: http.ProxyURL(proxyURL), // 这行被忽略
}
client.Transport = &http.Transport{} // 新 Transport 没配任何东西- 每次新建
http.Client时，若没指定Transport，Go 会用默认全局http.DefaultTransport—— 它共享连接池，但它的Proxy和超时不可变 - 生产环境应为不同用途（如 API 调用 vs 文件上传）创建独立
Client实例，各自配专属Transport，避免行为污染 - 记得调用
Transport.CloseIdleConnections()（如程序退出前），否则可能残留 TIME_WAIT 连接
调试代理失败或超时问题，优先看 net/http 的错误类型
代理失败时错误信息往往藏在底层，比如 "proxyconnect tcp: dial tcp 127.0.0.1:8888: connect: connection refused" 表示代理进程没起来；"net/http: request canceled (Client.Timeout exceeded while awaiting headers)" 说明卡在等响应头，该调 ResponseHeaderTimeout；而 "context deadline exceeded" 可能来自 DialContext 或顶层 Client.Timeout，得结合上下文判断。
- 不要依赖错误字符串做判断 —— 用
errors.Is(err, context.DeadlineExceeded)或url.Error类型断言更稳定 - 开启
GODEBUG=http2debug=1可查 HTTP/2 代理隧道问题（部分企业代理不支持 HTTP/2） - 临时加日志：在
DialContext函数里打点，确认是否真走到代理地址，还是被NO_PROXY拦截了
代理和超时看着简单，但 Transport 层的每个字段都可能成为漏网之鱼 —— 尤其是当你把 Client 当参数传进多个包，又混用默认 Transport 时，行为差异会非常隐蔽。
