Go 标准库支持通过 GODEBUG=http2debug=1 或 =2 环境变量开启内置 HTTP/2 协议层调试日志，无需修改代码即可输出连接建立、帧收发、流状态及超时等关键诊断信息，适用于生产环境事后排查。
go 标准库支持通过 `godebug=http2debug=1` 或 `=2` 环境变量开启内置 http/2 协议层调试日志，无需修改代码即可输出连接建立、帧收发、流状态及超时等关键诊断信息，适用于生产环境事后排查。
Go 自 1.6 起默认启用 HTTP/2（对启用了 TLS 的服务器及满足 ALPN 条件的客户端），其底层实现（net/http/h2_bundle.go）内置了细粒度的调试开关。通过设置 GODEBUG 环境变量，可实时输出协议交互全过程，是定位连接复用失败、流重置（RST_STREAM）、SETTINGS 协商异常、空闲超时（idle timeout）或写入阻塞等问题的首选轻量级手段。
启用方式如下：
- GODEBUG=http2debug=1：输出基础事件日志，包括连接创建/关闭、新流开启、HEADERS/PING/GOAWAY 帧收发、流状态变更（如 stream 1 → closed）。
- GODEBUG=http2debug=2：在 level 1 基础上增加 DATA 帧内容摘要（含长度、流 ID、是否结束标志）、窗口更新详情及更详细的错误上下文，适合深度分析传输行为。
# 启动服务时启用详细 HTTP/2 调试 GODEBUG=http2debug=2 go run main.go # 或在部署中通过 systemd 设置（示例） Environment="GODEBUG=http2debug=1"
日志示例（level 2）：
http2: Framer 0xc00012a000: wrote SETTINGS len=18, settings: ENABLE_PUSH=0, INITIAL_WINDOW_SIZE=4194304, MAX_FRAME_SIZE=16384 http2: Framer 0xc00012a000: read SETTINGS len=0 http2: Framer 0xc00012a000: wrote HEADERS frame to stream 1 (len=58; flags: END_HEADERS) http2: Framer 0xc00012a000: read DATA frame for stream 1 (len=128; flags: END_STREAM)
⚠️ 注意事项：
- 日志直接输出到 stderr，需确保生产环境日志收集系统能捕获标准错误流；
- http2debug 日志量较大（尤其 level 2），不建议长期全量开启于高流量服务，推荐结合问题时段临时启用，或通过条件启动（如健康检查端点触发）；
- 该机制仅作用于 Go 标准库 net/http 的 HTTP/2 实现，对第三方 HTTP 客户端（如 golang.org/x/net/http2 手动配置场景）同样有效，但不覆盖非标准库的网络层（如自定义 TLS 握手或底层 socket 操作）；
- 若使用 http.Transport 自定义配置，请确保未禁用 HTTP/2（如未设置 ForceAttemptHTTP2 = false），否则调试开关无效。
综上，GODEBUG=http2debug 是 Go 生态中开箱即用、零侵入、高信息密度的 HTTP/2 故障诊断工具——它不依赖外部代理或抓包，也不需要重构代码，是 SRE 和后端工程师在生产环境中快速还原 HTTP/2 会话现场的可靠选择。
