Go 版本或 Transport 配置变更后，如何重新检查代理连接

Go 的代理 IP 行为由版本、环境变量和 Transport 配置共同决定，任何一项变化都可能改变实际走向。回归的关键是把“代理从哪来”和“请求走到哪一步”都变成可观测的。下面用标准库的 httptrace 与会话复用指标做示范，测试在自有服务与测试出口上进行。

升级后先确认 Go 版本和哪些配置变了

先记录 Go 版本、构建选项和代理环境配置，作为升级前后对照基线：

• Go 版本：go version，大版本升级可能改变默认 TLS 与 HTTP/2 行为；
• GOFLAGS 与构建标签：是否启用或关闭了某些默认行为；
• 环境变量：HTTP_PROXY、HTTPS_PROXY、NO_PROXY 是否被设置，以及大小写写法。

HTTP_PROXY 与 http_proxy 的处理及 NO_PROXY 匹配规则应按 Go 版本核实。回归前记录变量是否设置、脱敏后的主机/端口与绕过规则，再和升级前记录对比。不要输出含 URL userinfo、口令或完整凭据的代理环境变量。

Go 请求最终使用了哪种代理配置？

最终用哪套配置，以当前请求实际使用的 Transport 和绕过规则为准。除了 Proxy，还要检查自定义 DialContext、NO_PROXY、重定向和连接池；环境变量是否被读取还取决于读取时机，不能只看代码或环境变量就下判断。

```go
tr := &http.Transport{
Proxy: http.ProxyFromEnvironment, // 读环境变量
// Proxy: http.ProxyURL(proxyURL), // 显式指定
TLSHandshakeTimeout: 5 * time.Second,
}
client := &http.Client{Transport: tr, Timeout: 30 * time.Second}
req, _ := http.NewRequest("GET", "https://api.example.com/v1/models", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("API_KEY"))
resp, err := client.Do(req)
```

若 Transport.Proxy 显式设置了代理函数或地址，请求将按该配置处理，不会再由另一套环境变量配置替代。使用标准库 ProxyFromEnvironment 时，代理环境配置存在进程级缓存行为；按目标 Go 版本核对实现。修改环境变量后，应在设置好环境的新进程中测试，只新建 Transport 不保证刷新缓存。需要运行时动态选择代理时，用明确管理的 Proxy 函数或 ProxyURL，并单独管理连接池。

在隔离测试环境中，可将代理地址指向不可用端口作为负向测试。请求仍成功只说明该请求没有依赖这个代理配置；还应排查 NO_PROXY、其他代理设置、连接复用等因素，并核对最终出口。

NO_PROXY 命中时请求会绕过代理；应把匹配结果与实际出口一起核对。

怎么用 httptrace 定位连接耗时？

httptrace 提供的是阶段事件，不是现成的耗时报表；需要在事件回调里记时间戳、算差值，再和总耗时对照。

```go
start := time.Now()
var dnsStart, connStart, tlsStart time.Time
trace := &httptrace.ClientTrace{
DNSStart: func(httptrace.DNSStartInfo) { dnsStart = time.Now() },
DNSDone: func(httptrace.DNSDoneInfo) { log.Printf("dns %v", time.Since(dnsStart)) },
ConnectStart: func(network, addr string) { connStart = time.Now(); log.Printf("connect start %s %s", network, addr) },
ConnectDone: func(network, addr string, err error) { log.Printf("connect done %s %v %v", addr, time.Since(connStart), err) },
TLSHandshakeStart: func() { tlsStart = time.Now() },
TLSHandshakeDone: func(cs tls.ConnectionState, err error) {
log.Printf("tls %v proto=%s", time.Since(tlsStart), cs.NegotiatedProtocol)
},
GotFirstResponseByte: func() { log.Printf("ttfb %v", time.Since(start)) },
}
req = req.WithContext(httptrace.WithClientTrace(req.Context(), trace))
```

开始事件与完成事件要成对记录，才能计算 DNS、拨号、TLS 等阶段时长；只注册起点不会得到 duration。示例中的单一时间变量只适用于串行、单次尝试；Happy Eyeballs 等情况下可能并发或多次触发回调，应按连接尝试关联时间戳，并用互斥锁或并发安全结构保护。若连接复用，可能没有新的拨号事件，缺事件不等于零耗时。代理下 ConnectStart 的目标通常是代理地址；经 HTTP 代理时 DNS 也可能由代理完成。

移动应用场景的 DNS、连接和 TLS 分阶段定位方法，可参考移动 App 网络兼容测试：五个失败阶段定位法。

怎么确认连接复用和超时设置仍然生效？

检查连接池配置与 GotConn 事件，比较同一负载下的复用结果：

• DisableKeepAlives: true 会让每个请求重新建连；
• TLSHandshakeTimeout 过短会在跨境链路上频繁失败；
• MaxIdleConnsPerHost 过低会导致高并发时连接被丢弃重建。

观测方式：看 httptrace.GotConn 回调里 info.Reused 的取值，统计连续请求中的复用比例。复用比例受请求模式、连接池和服务端行为影响，不设统一阈值；将升级前后相同负载下的结果对照，异常时再检查配置和默认值。

升级后 HTTP/2 或 TLS 协商有什么变化？

Go 版本升级可能改变 HTTP/2 启用条件和 TLS 默认值，判断时以 Go 客户端自己的结果为准。

• 自定义 TLSClientConfig 可能关闭 HTTP/2；
• ForceAttemptHTTP2 的设置会影响协商结果；
• 最低 TLS 版本提升后，旧代理或中间设备可能握手失败。

以 Go 的 resp.Proto、resp.TLS.NegotiatedProtocol（TLS 响应时）及客户端日志作为 Go 实际协商结果。curl 只能作显式相同代理、目标和路径下的独立对照，不能代表 Go 客户端结果：

```bash
curl -sI -o /dev/null -w '%{http_version}\n' https://api.example.com/
```

该命令只显示 curl 自己的协商结果；Go 的结果以 resp.Proto 与 TLS 状态为准。两者不一致时，先确认代理、目标和请求路径相同，再检查 Go 版本、tls.Config 与代理隧道能力。

怎么判断代理连接回归通过？

可按下表对照代理来源、分阶段耗时、连接复用、协议协商及超时重试。

• 检查项：代理来源 ｜ 观测点：检查 Transport.Proxy、绕过规则及实际出口 ｜ 正常表现：与预期代理配置和出口一致
• 检查项：分阶段耗时 ｜ 观测点：httptrace 成对事件算出的各段时长 ｜ 正常表现：各段与升级前同一量级
• 检查项：连接复用 ｜ 观测点：GotConn 的 Reused ｜ 正常表现：与升级前相同负载下的基线对照
• 检查项：Go 协商协议 ｜ 观测点：resp.Proto 与 TLS 状态 ｜ 正常表现：按目标服务、代理路径和升级前基线核对
• 检查项：超时与重试 ｜ 观测点：三类超时的触发日志 ｜ 正常表现：各按预期触发，次数不变

如果实际出口与配置不符，先检查 Transport.Proxy 和绕过规则；若某阶段耗时变化，检查对应的连接与超时配置；HTTP/2 协商结果变化时，再核对 Go 版本、TLS 配置和代理支持情况。

Go net/http 官方文档

FAQ

Q：环境变量代理设置会自动覆盖自定义 Transport 吗？

A：取决于 Transport.Proxy 是否显式设置及 Go 版本行为，应以实际配置和版本文档为准。

Q：测试关闭连接复用会代表线上表现吗？

A：不会。它适合隔离连接问题，结果应与默认复用配置分开记录。

Q：只在一个 Go 版本通过是否足够？

A：若生产使用多个版本，应覆盖实际部署版本及升级目标版本。