ERR_HTTP2_PROTOCOL_ERROR根本原因是HTTP/2降级路径未打通,需自底向上排查:确认Go http.Server TLS配置与ALPN协商、抓包验证ClientHello/ServerHello中h2字段、检查反向代理是否拦截协议、直连验证降级是否生效。

HTTP/2 降级失败导致请求卡死或 ERR_HTTP2_PROTOCOL_ERROR,根本不是“要不要降级”的问题,而是降级路径没走通——客户端仍试图用 HTTP/2 连接,但服务端已禁用或中间层拦截了协议协商。Kratos 本身不控制 HTTP/2 开关,它完全依赖底层 Go http.Server 和 TLS 配置,排查必须从协议栈底向上验证。
确认 Go http.Server 是否启用 HTTP/2
Kratos 的 HTTP 服务基于标准 net/http,而 Go 1.6+ 默认为 TLS 连接启用 HTTP/2,但有两个硬性前提:
- 服务必须使用 TLS(即监听
https),明文http://不会协商 HTTP/2; -
http.Server.TLSConfig必须非 nil,且TLSConfig.NextProtos包含"h2"(Go 默认已设,除非你手动覆盖)。
检查 internal/server/http.go 中是否调用了 http.ListenAndServeTLS 或传入了有效 tls.Config。若用 http.ListenAndServe(明文),无论客户端怎么发 ALPN,都只会走 HTTP/1.1,也谈不上“降级”——此时看到的错误大概率是别的原因。
抓包验证 ALPN 协商是否成功
浏览器或客户端是否真在 TLS 握手时声明支持 h2,服务端是否响应了该协议,仅看日志无法确认。必须用 Wireshark 或 tshark 抓 TLSv1.2+ 的 ClientHello 和 ServerHello:
- 过滤条件:
tls.handshake.type == 1 or tls.handshake.type == 2; - 在 ClientHello 的
Extension: ALPN字段中,应看到h2和http/1.1并存; - ServerHello 的 ALPN extension 应返回
h2(若想强制 HTTP/2)或http/1.1(若已禁用 HTTP/2)。
如果 ServerHello 没返回 ALPN,或返回空,说明 Go http.Server 拒绝了 HTTP/2 —— 常见于 TLSConfig.Certificates 为空、证书链不全、或 NextProtos 被清空。
检查反向代理或 CDN 是否干扰协议协商
Kratos 服务常部署在 Nginx、Traefik 或 Cloudflare 后面。这些组件可能主动终止 HTTP/2 或改写 ALPN:
- Nginx:确认配置中
listen 443 ssl http2;已移除(降级时),且proxy_http_version 1.1;已设,否则 upstream 仍收 HTTP/2 流; - Traefik:检查
entryPoints.websecure.http.tls.options是否禁用了alpnProtocols; - Cloudflare:免费版默认关闭 HTTP/2 到源站(只保留在边缘),需确认 “Origin Server Protocol” 设置为 “HTTP/1.1” 或 “Follow”。
绕过代理直连 Kratos 服务(如 curl -vk --http1.1 https://localhost:8000/health)能快速区分问题是出在 Kratos 本体还是中间层。
验证客户端是否真的收到 HTTP/1.1 响应
即使服务端降级成功,客户端也可能因缓存、连接复用或早期帧污染继续发 HTTP/2 请求。最直接的验证方式是加 -v 看 curl 输出:
curl -v --http1.1 https://your-domain.com/health
注意输出中是否有:
-
> GET /health HTTP/1.1(而非HTTP/2); (状态行明确标出版本);- 无
alt-svc头或Upgrade: h2头。
如果仍看到 HTTP/2 字样,说明降级未生效;如果看到 HTTP/1.1 但报 ERR_HTTP2_PROTOCOL_ERROR,基本可断定是前端(Chrome)复用了之前失败的 HTTP/2 连接池,需彻底关闭标签页或禁用 chrome://flags/#enable-http2 临时验证。
真正棘手的点往往不在 Kratos 代码里,而在 TLS 证书加载失败导致 http.Server 静默回退到 HTTP/1.1、或代理把 h2 ALPN 响应截断却没报错——这些地方日志通常沉默,必须靠抓包和直连交叉验证。


















