Go原生支持HTTP/2(自1.8起默认启用,需TLS配置),但完全不支持HTTP/3;必须用ListenAndServeTLS或设置TLSConfig才能启用HTTP/2,纯HTTP始终为HTTP/1.1。

Go 默认支持 HTTP/2,但必须走 HTTPS
Go 从 1.8 版本起,只要使用 http.ListenAndServeTLS 或配置了 TLSConfig 的 http.Server,就会自动启用 HTTP/2 —— 不需要导入额外包,也不用调用 http2.ConfigureServer。这不是可选项,而是默认行为。关键前提是:必须是 TLS 连接。用 http.ListenAndServe 启动的纯 HTTP 服务,永远只能是 HTTP/1.1,无论你怎么配都升不了级。
常见错误是以为加 NextProtos: []string{"h2"} 就能“开启” HTTP/2。其实 Go 默认已包含 "h2" 在 ALPN 协商列表里,显式设置它既不必要,也不解决根本问题。真正卡住的,往往是证书或端口配置。
- 自签名证书可用
generate_cert.go生成,但 Chrome 会直接降级到 HTTP/1.1;开发时需手动信任证书,或启动 Chrome 时加--unsafely-treat-insecure-origin-as-secure="https://localhost:8080" -
bind: permission denied是非 root 用户尝试绑定 443 端口所致;改用:8443更安全,或用sudo setcap 'cap_net_bind_service=+ep' ./myserver - 反向代理(如 Nginx 默认配置)可能终止 TLS 并以 HTTP/1.1 转发,此时 Go 服务看到的仍是
r.Proto == "HTTP/1.1",不是你的代码问题
如何确认服务真正在用 HTTP/2
别信文档,看实际协商结果。Chrome DevTools 的 Network 面板 → 点开任意请求 → Headers 标签页 → 查 “Protocol” 列是否显示 h2。这是最直观、最可靠的方式。
命令行下用 curl -v --http2 https://localhost:8080,重点看输出中是否有:
ALPN, offering h2 SSL connection using TLSv1.2 / ECDHE-RSA-AES256-GCM-SHA384
注意:curl 必须是 7.47+ 且编译时启用了 nghttp2;macOS 系统自带的 curl 不支持,得用 brew install curl-openssl 替换。
- 服务端可在 handler 里打印
r.Proto:HTTP/2 请求返回HTTP/2.0,HTTP/1.1 返回HTTP/1.1 - Wireshark 抓包过滤
http2或查看 TLS 握手帧里的 ALPN 字段是否含h2 -
curl -I --http2 https://...若状态行显示HTTP/2 200,说明协商成功
HTTP/2 Server Push 已不可用,别再试了
http.Pusher 接口在 Go 1.23 中被标记为 deprecated,而早在 1.22 之前,它就只是个空壳:调用 p.Push() 大概率返回 http: server doesn't support HTTP/2 push 或直接 panic。这不是你配置错了,是标准库压根没实现推送逻辑。官方明确表示该功能有设计缺陷,现代浏览器(Chrome 96+、Firefox 97+、Edge 96+)也已全面禁用。
强行启用(比如用 http2.ConfigureServer)也不会让 Pusher 生效,反而可能破坏连接复用或触发 PROTOCOL_ERROR。所有声称“支持 Go HTTP/2 Push”的第三方库,实际都只是包装了 Link 响应头。
- 替代方案是写
Link头:w.Header().Set("Link", `<style.css>; rel=preload; as=style`)</style.css> -
Link在 HTTP/1.1 和 HTTP/2 下都有效,且由客户端自主控制预加载时机,无队头阻塞风险 - 路径必须是绝对路径(
/style.css),不能是相对路径或带协议的 URL - 不要 push 大文件(>1MB)或非关键资源,否则拖慢首屏
Go 不支持 HTTP/3,别被误导
截至 2026 年 4 月,Go 标准库仍**完全不支持 HTTP/3**。任何说“Go 原生支持 HTTP/3”的文章,要么过时,要么混淆了第三方库(如 quic-go)与标准库。HTTP/3 依赖 QUIC 协议栈,而 net/http 没有集成它。生产环境若需 HTTP/3,只能靠前端反向代理(如 Nginx + quiche)或用 quic-go 自建服务器 —— 但这已脱离标准库范畴。
HTTP/2 的价值在于多路复用和头部压缩,这些在 Go 里开箱即用;而 HTTP/3 的收益(如 0-RTT、连接迁移)在多数 Web 场景下并不显著,且引入了 UDP 可靠性、防火墙穿透等新复杂度。先确保 HTTPS + HTTP/2 跑稳,比强上 HTTP/3 更实在。


















