Gin 本身不直接支持 HTTP/2，必须通过 net/http.Server 配置启用；r.Run() 使用 http.ListenAndServe() 仅支持 HTTP/1.1，而 r.RunTLS() 或手动构建 http.Server 并调用 ListenAndServeTLS() 才能在 TLS 下自动协商 HTTP/2，且需有效证书、Go ≥1.8、端口为 HTTPS（如 443）。
Gin 本身不直接支持 HTTP/2，必须靠 net/http.Server 配置启用。Gin 只是封装了 http.Handler，底层仍依赖 Go 标准库的 http.Server。HTTP/2 的启用与否，完全取决于你如何启动服务——不是调用 r.Run() 就能自动开启。
为什么 r.Run() 默认不启用 HTTP/2？
因为 r.Run() 内部使用的是 http.ListenAndServe()，而这个函数只支持 HTTP/1.1。Go 的 http.ListenAndServeTLS() 才在 TLS 场景下自动协商 HTTP/2（前提是客户端也支持），但 Gin 默认不走 TLS 启动。
-
r.Run()→ 调用http.ListenAndServe()→ 仅 HTTP/1.1 -
r.RunTLS()→ 调用http.ListenAndServeTLS()→ TLS + 自动 HTTP/2 协商（需有效证书） - 手动构造
http.Server→ 可显式控制TLSConfig、IdleTimeout等，更可靠
正确启用 HTTP/2 的两种方式
必须提供 TLS 证书（自签名也可，但浏览器会警告；生产环境需正式证书）。纯 HTTP（非 TLS）无法启用 HTTP/2（Go 标准库强制要求）。
- 用
r.RunTLS()快速验证：r := gin.Default() r.GET("/ping", func(c *gin.Context) { c.JSON(200, gin.H{"status": "ok"}) }) // 注意：cert.pem 和 key.pem 必须存在且格式正确 r.RunTLS(":443", "cert.pem", "key.pem") - 手动构建
http.Server（推荐用于生产）：r := gin.Default() srv := &http.Server{ Addr: ":443", Handler: r, TLSConfig: &tls.Config{ // 强制只用 TLS 1.2+，兼容 HTTP/2 MinVersion: tls.VersionTLS12, }, } log.Fatal(srv.ListenAndServeTLS("cert.pem", "key.pem"))
常见失败原因和坑
即使代码写对，HTTP/2 仍可能不生效，主要卡在这些地方：
立即学习“go语言免费学习笔记（深入）”；
- 证书无效：自签名证书未被系统或浏览器信任 → 浏览器降级为 HTTP/1.1，
curl -v https://...会显示ALPN, offering http/1.1而不是h2 - 端口非 443 或未配 TLS：HTTP/2 在 Go 中只通过 TLS 启用（不支持明文 HTTP/2，即 h2c）
- Go 版本低于 1.8：HTTP/2 支持从 Go 1.6 引入，但稳定性和默认行为在 1.8+ 更可靠
- 反向代理（如 Nginx）拦截了 TLS：此时实际连接是 HTTP/1.1 到 Nginx，Nginx 再转 HTTPS 到 Gin → Gin 看不到 TLS，无法启用 HTTP/2
真正要确认是否跑在 HTTP/2 上，别信日志，用 curl -I --http2 https://yourdomain.com 或浏览器 DevTools 的 Network → Protocol 列看是否显示 h2。Gin 层面完全无感知，它只管处理 *gin.Context，协议协商全由 net/http 和 TLS 底层完成。
