go标准库net/http自1.6起原生支持http/2，但必须通过tls启用；go 1.8+默认自动协商h2，无需手动配置nextprotos，只需使用listenandservetls或配置tlsconfig后调用listenandservetls。
Go 的 net/http 包才是 HTTP/2 的实际实现者
框架（Gin、Echo、Fiber）本身不处理 HTTP/2 协议——它们只是基于 net/http 构建的路由和中间件层。真正完成 TLS 握手、ALPN 协商、帧解析、流调度、头部压缩等工作的，是 Go 标准库的 net/http 和底层 golang.org/x/net/http2。框架里你写的 HandlerFunc，最终被传给 http.Server，而后者在调用 ListenAndServeTLS 时会自动启用 HTTP/2 支持（Go 1.8+）。
常见误解是“框架要配 HTTP/2 开关”，其实只要满足两个硬性条件，HTTP/2 就自动生效：
- 必须使用
ListenAndServeTLS或配置了TLSConfig的Server.ListenAndServeTLS，不能用ListenAndServe - TLS 配置需支持 ALPN，且包含
"h2"（Go 1.8+ 默认注入，除非你手动清空NextProtos）
为什么你的服务没走 HTTP/2？先查这三件事
不是代码没写对，而是环境或配置卡在协商链路上。验证顺序比写法更重要：
- 用
curl -v --http2 https://localhost:8443/health查日志：看到ALPN, offering h2和SSL connection using TLSv1.2 / ECDHE才算协商成功；若只有http/1.1，说明降级了 - 浏览器 DevTools → Network → 点开请求 → Headers → “Protocol” 列显示
h2，不是http/1.1或空白 - 服务端 Handler 中打印
r.Proto：HTTP/2 请求输出是HTTP/2.0，不是HTTP/1.1
高频失败点：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 用自签名证书但没用
mkcert生成本地可信 CA，Chrome/Firefox 直接拒绝连接，curl 要加-k但依然可能因 ALPN 失败降级 - 反向代理（如 Nginx、Traefik）终止 TLS 后以 HTTP/1.1 转发到后端，此时 Go 服务看到的是
HTTP/1.1，跟 Go 无关 -
TLSConfig.NextProtos被误设为[]string{"http/1.1"}，显式剔除了"h2"
客户端复用连接池才能发挥 HTTP/2 多路复用优势
HTTP/2 的价值不在“协议新”，而在“一个连接并发跑多个流”。但如果客户端每次请求都新建 http.Client，或 Transport 配置不当，就会退化成多个 TCP 连接，完全浪费 HTTP/2。
-
http.Client必须全局复用，它的Transport是线程安全的；别在 handler 里 new client -
Transport.MaxIdleConnsPerHost至少设为100（默认是2），否则每个 host 限 2 个空闲连接，根本撑不起并发流 -
Transport.IdleConnTimeout设为30~90秒：太短导致频繁重连，太长则net.Conn占满 fd - 不用手动设
ForceAttemptHTTP2 = true（默认就是true），但确保TLSClientConfig.NextProtos包含"h2"
验证是否真复用：启动服务后，用 ss -tn | grep :8443 | wc -l 查活跃连接数。高并发下若只维持 1–2 个连接，说明多路复用生效；若连接数随请求数线性增长，就是连接池失效。
响应体阻塞写入会破坏流级并发
HTTP/2 多路复用依赖帧级调度，但如果你的 handler 一次性把大文件读进内存再 w.Write(buf)，整个流会独占连接带宽，其他并发流被迫排队——效果类似 HTTP/1.1 队头阻塞，只是发生在流粒度。
- 用
io.Copy(w, file)或io.CopyN(w, reader, limit)分块传输，避免全量加载 - 禁止在 handler 里做同步耗时操作：比如直连数据库查 10 万行再序列化 JSON；应加
context.WithTimeout(r.Context(), 5*time.Second)包裹下游调用 - 中间件若需读取
r.Body（如鉴权、日志），必须用io.ReadCloser包装并还原 body，否则后续 handler 读不到数据，且无报错
Pusher 接口已废弃：http.Pusher 在 Go 1.23 标记为 deprecated，现代浏览器也基本移除支持，别再依赖它优化首屏——改用 preload 或内联关键资源更可靠。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
