HTTP 与 Web 标准 / 系统课时

客户端为什么始终回退到 h1

客户端为什么始终回退到 h1

客户端明明发起 HTTPS 请求,却始终看到 HTTP/1.1,通常不是单一配置错误。最有效的定位方式是沿着客户端能力、TLS 的 ALPN 协商、中间代理和服务端入口逐层验证,找到真正发生降级的位置。

学习目标

  • 判断客户端是否真正具备 HTTP/2 能力
  • 使用 ALPN 结果区分客户端、代理和服务端问题
  • 建立从客户端到入口服务的最短协议协商排查链路

明确回退发生在哪一层

HTTPS 场景下,HTTP/2 通常通过 TLS 握手中的 ALPN 完成协商。客户端声明自己支持的应用层协议,例如 h2 和 http/1.1,服务端或实际终止 TLS 的中间节点从中选择一个协议。

因此“最终使用 h1”至少可能有四类原因:客户端本身没有 HTTP/2 支持;客户端没有发送 h2 ALPN;代理终止 TLS 后只向客户端提供 HTTP/1.1;或者服务端入口没有启用 HTTP/2。

HTTP 协议回退分层定位链路

一个重要边界是:反向代理到后端使用 HTTP/1.1,并不代表浏览器到反向代理也只能使用 HTTP/1.1。客户端看到的协议由它与 TLS 终止节点之间的协商决定,排查时必须先确定 TLS 究竟终止在哪里。

先验证客户端和 ALPN

第一步检查客户端构建是否包含 HTTP/2 支持。以 curl 为例,可以查看自身能力,而不是直接修改服务端配置。

bash
curl -V

预期输出中应能看到当前 curl 的版本、协议和特性列表。如果这个构建支持 HTTP/2,Features 中会包含 HTTP2;具体版本号和其他特性会因环境不同而变化。

text
curl <VERSION> ...
Protocols: ... http https ...
Features: ... HTTP2 ...

如果 HTTP2 不存在,继续检查 ALPN 没有意义,应先更换或重新构建支持 HTTP/2 的客户端。这里尤其要注意同一台机器上的系统 curl、包管理器 curl 和应用内置 libcurl 可能不是同一个构建。

客户端具备能力后,直接检查目标 TLS 入口是否愿意协商 h2。将 <HOST> 替换为真实域名后执行:

bash
HOST="<HOST>"
echo | openssl s_client -alpn h2,http/1.1 -connect "${HOST}:443" -servername "${HOST}" 2>/dev/null | grep -E 'ALPN protocol|No ALPN negotiated'

当目标入口正确启用 HTTP/2 且路径没有改变协商结果时,预期结果为:

text
ALPN protocol: h2

如果得到 ALPN protocol: http/1.1,说明实际终止 TLS 的节点明确选择了 h1;如果出现 No ALPN negotiated,则需要检查 TLS 终止节点是否启用了 ALPN,以及请求是否经过了不支持对应协商的中间设备。

再排代理和服务端

企业网络中最容易误判的是 TLS 被代理提前终止。客户端认为自己连接的是业务域名,但实际 TLS 会话可能结束在正向代理、安全网关、WAF、CDN 或负载均衡器。此时后端服务是否启用 HTTP/2,并不能决定客户端这一跳使用什么协议。

排查时先确认 DNS 和连接目标,再确认是否配置了显式代理,以及企业环境是否存在 HTTPS 检查。如果证书签发者变成企业内部 CA,也可能意味着 TLS 已被安全设备重新终止,此时应该检查该设备对客户端侧 ALPN 的支持。

对于反向代理,还应分别检查客户端到代理、代理到上游两段协议。客户端到代理可以是 h2,而代理到上游继续使用 h1;这种架构完全有效,不应把后端访问日志中的 HTTP/1.1 直接解释成客户端发生了降级。

一条最短定位链

完成 ALPN 检查后,再让 curl 直接报告最终使用的 HTTP 版本。将 <HOST> 替换为实际域名:

bash
curl -sS -o /dev/null --http2 -w 'http_version=%{http_version}\n' "https://<HOST>/"

如果这一跳成功协商 HTTP/2,预期结果为:

text
http_version=2

如果仍然得到 http_version=1.1,可以按固定顺序定位:

  1. 检查 curl -V 是否包含 HTTP2。
  2. 使用 OpenSSL 检查实际 TLS 连接是否协商出 h2。
  3. 确认客户端是否配置显式 HTTP 或 HTTPS 代理。
  4. 确认链路中是否存在会终止 TLS 的安全设备、WAF 或负载均衡器。
  5. 在真正的 TLS 终止节点检查监听端口和 HTTP/2 配置,而不是只检查后端应用。

这种顺序可以把问题快速划分为“客户端没有能力”和“链路没有提供 h2”两大类,避免一开始就在服务器配置中反复试错。

修复后如何验收

修复后不要只看服务端配置文件是否包含 HTTP/2 相关选项,而应从真实客户端重新执行协议检测。至少确认 ALPN 返回 h2,客户端报告 http_version=2,并在经过生产代理、防火墙或负载均衡的真实路径上再次验证。

如果直连入口能够得到 h2,而经过企业代理后变成 h1,问题就在代理路径;如果 OpenSSL 已经协商 h2,但特定应用仍然使用 h1,则应继续检查该应用实际使用的 HTTP 库、代理设置和连接复用配置。

还要避免把明文 HTTP/2 的 h2c 与 HTTPS 下的 h2 混为一谈。主流 HTTPS 场景关注的是 TLS 和 ALPN,明文 h2c 使用不同的建立方式。只要按照客户端能力、ALPN、中间节点、TLS 终止入口这个顺序逐层检查,HTTP/1.1 回退通常都能被定位到明确的一跳。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

客户端为什么始终回退到 h1

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通