Go HTTP/2 代理连接怎么调试：Transport、TLS 与连接复用
调试 Go HTTP/2 代理连接时，分开检查 Transport、CONNECT、TLS/ALPN、连接池和超时，并用日志确认每一层的实际状态。
Go 的代理连接、TLS 握手和 HTTP/2 协商处于不同阶段。先确认实际使用的 Transport，再按 CONNECT、TLS、ALPN、连接池和超时顺序定位。
Go 的代理隧道、TLS 握手和 HTTP/2 协商处于不同阶段。先确认实际请求使用的 http.Transport，再按连接建立顺序定位；HTTP/2 不是代理 IP 类型。
如何确认请求使用了目标 Transport
检查 Proxy、DialContext、TLSClientConfig 和各级超时是否来自同一个 Transport。SDK 可能覆盖自定义 RoundTripper，因此日志应记录目标 URL、代理地址、Transport 标识和连接耗时。无法确认实例时，先做一个最小请求并与直连结果对照。
多语言接入示例可参考代理 IP 代码示例中心。
CONNECT、TLS 和 ALPN 的排查顺序
CONNECT 成功只表示代理隧道建立，不代表目标 TLS 或 HTTP/2 已成功。分别记录 CONNECT 状态、TLS 版本、证书校验、ALPN 提供值和最终协商协议；未得到 h2 时先核对 Go 客户端与目标站支持，不要关闭证书校验。
需要区分代理协议和 TLS 连接层时，可参考HTTP、HTTPS、SOCKS5 代理怎么选。
下面按连接建立顺序把日志字段对应到故障阶段。
| 阶段 | 观察字段 | 常见异常 | 下一步 |
|---|---|---|---|
| CONNECT | 状态码、认证结果 | 407、连接拒绝 | 查代理认证和主机端口 |
| TLS | 证书、版本、耗时 | 校验失败、握手超时 | 查 CA 和中间层 |
| ALPN | 提供值、协商协议 | 未得到 h2 | 查客户端和目标支持 |
| 响应头 | 首字节、响应头耗时 | 长时间无响应 | 区分上游等待和网络延迟 |
| 连接池 | 新建/复用、关闭时间 | 仅复用失败 | 关闭复用做对照 |
从最早异常的阶段开始处理，再比较新建连接和复用连接的差异。
连接池复用和超时问题怎么查
把 connect、TLS handshake、response header 和 read 分开计时。若只有复用连接失败，暂时关闭空闲连接或新建 Transport 做对照；若新建连接也在同一阶段超时，再回查该阶段的网络或 TLS。
连接池参数和并发规划可进一步参考代理 IP 并发、QPS 和连接池怎么规划。
一轮调试至少应确认隧道、证书和协议结果，并记录新建与复用连接的差异。
如何从日志定位失败阶段
建议在不记录认证值的前提下，保存目标 URL、Transport 标识、代理地址摘要、CONNECT 状态、TLS 版本、证书校验结果、ALPN 提供值、最终协议、response header 时间和 read 时间。若 CONNECT 失败，先处理代理认证或主机端口；若 TLS 失败，检查 CA 和中间层；若只在复用连接失败，比较 idle connection 的创建和关闭时间。
怎样确认 HTTP/2 协商成功
一轮调试至少应确认：请求确实使用预期 Transport、CONNECT 隧道建立、证书校验通过、ALPN 结果符合目标支持情况。目标站不支持 h2 时，未协商到 h2 不等于代理故障，应确认客户端能否按目标支持的协议继续请求。
用一组日志区分新建连接和复用连接
可用脱敏字段把失败阶段映射到日志，不要记录认证值：
```text
url=https://api.example.test/ping transport=T1 connect=120ms tls=85ms alpn=h2 response_header=210ms read=18ms status=200
url=https://api.example.test/ping transport=T1 reused=true connect=0ms response_header=timeout
```
第一行表示隧道、TLS、HTTP/2 和响应均完成；第二行只在复用连接超时，应先关闭空闲连接做新建连接对照。HTTP/HTTPS/SOCKS5 透明代理接入仍只需要主机、端口、账号和密码；TLS/证书/ALPN 是目标连接诊断字段，不是额外代理账号字段。
FAQ
CONNECT 成功是否代表 HTTP/2 可用？
不代表，后面还要完成 TLS 和 ALPN 协商。
如何确认请求使用了预期的 Transport？
检查实际客户端使用的 Transport，以及 Proxy、DialContext 和 TLS 配置是否属于该实例。SDK 或自定义 RoundTripper 可能覆盖单独创建的 Transport。
ALPN 没有协商到 h2 时先检查什么？
先确认目标站支持 HTTP/2，再检查 Go 客户端配置和 TLS 中间层。没有协商到 h2 不一定代表代理连接失败。
只有连接池复用时出错怎么办？
用新建连接做对照。如果新连接正常，再检查 idle connection 的生命周期和 Transport 复用设置。