HTTP 与 Web 标准 / 系统课时
用 curl 检查协议支持情况
用 curl 检查协议支持情况
在开始 HTTP/2 或 HTTP/3 实验前,先确认本机 curl 是否具备对应能力,再检查目标站点最终协商出了什么协议。这样可以快速区分“客户端根本不支持”“服务器没有协商成功”和“命令参数使用错误”三类问题。
学习目标
- 使用
curl -V判断当前构建是否包含 HTTP/2、HTTP/3 能力 - 使用 curl 显式请求不同 HTTP 版本并查看实际协商结果
- 根据报错位置判断问题来自客户端能力还是远端协议支持
先检查 curl 自身能力
curl 是否支持 HTTP/2 或 HTTP/3,不只取决于版本号,还取决于构建时链接的协议库。最直接的办法是查看版本信息和 Features 行。
curl -V预期输出会因系统和构建方式不同而变化,重点检查类似下面的字段;<VERSION>、<LIBRARIES> 和功能列表以本机实际输出为准。
curl <VERSION> <PLATFORM> <LIBRARIES>
Protocols: <PROTOCOLS>
Features: <FEATURES>如果 Features 中包含 HTTP2,当前 curl 构建具备 HTTP/2 支持;包含 HTTP3 才表示具备 HTTP/3 支持。只看到较新的 curl 版本号,并不能推断一定支持 HTTP/3。
检查 HTTP/2 协商结果
对于 HTTPS 地址,可以让 curl 尝试使用 HTTP/2,再通过 %{http_version} 输出最终实际采用的 HTTP 版本。下面使用公开站点作为观察对象,远端配置可能随时间变化,因此应以命令实际返回值为准。
curl -sS -o /dev/null --http2 -w '%{http_version}\n' https://example.com/如果客户端具备 HTTP/2 能力且服务器成功协商 HTTP/2,预期结果为:
2如果结果为 1.1,说明这次连接最终没有使用 HTTP/2。若 curl 直接提示当前构建不支持 --http2 所需能力,则问题在客户端,不需要继续怀疑服务器。
--http2 对 HTTPS 请求表示优先尝试通过 TLS 的 ALPN 协商 HTTP/2,而不是绕过协商强制服务器接受 h2。服务器不提供 h2 时,实际结果可能回退到 HTTP/1.1。
检查 HTTP/1.1 作为对照
为了确认观察方法本身没有问题,可以显式限制为 HTTP/1.1,然后输出最终协议版本。这个命令适合作为后续实验的基线。
curl -sS -o /dev/null --http1.1 -w '%{http_version}\n' https://example.com/预期结果为:
1.1如果这一条能够正常完成,而 --http2 在执行前就报告“不支持该选项对应的协议能力”,通常说明网络和 HTTPS 基础连接没有问题,差异主要来自本机 curl 的构建能力。
检查 HTTP/3 支持
HTTP/3 检查需要同时满足两个条件:本机 curl 构建包含 HTTP/3 支持,目标服务器也提供 HTTP/3。可以先确认 curl -V 中出现 HTTP3,再对已知提供 HTTP/3 的测试目标执行请求。
curl -sS -o /dev/null --http3-only -w '%{http_version}\n' https://cloudflare-quic.com/当本机和远端都成功建立 HTTP/3 连接时,预期结果为:
3如果当前 curl 不认识 --http3-only,或者提示构建缺少 HTTP/3 支持,应先解决客户端安装问题。如果选项可用但连接失败,则还需要检查目标站点当前是否提供 HTTP/3,以及本地网络、防火墙或代理是否允许相关 UDP 流量。
用详细日志确认协商过程
只看最终版本适合快速判断;需要排查原因时,可以增加 -v 查看连接和协议协商信息。详细日志会写到标准错误,因此下面保留响应体丢弃,只观察诊断信息。
curl -v -o /dev/null --http2 https://example.com/成功协商 HTTP/2 时,日志中通常能够看到 TLS/ALPN 最终选择 h2,以及请求使用 HTTP/2 的相关信息。不同 curl 与 TLS 后端的具体措辞可能不同,因此应关注“最终选择了哪个协议”,不要依赖某一条固定日志文本。
预期结果可概括为:
<连接与 TLS 日志>
<ALPN 协商并选择 h2 的信息>
<HTTP/2 请求与响应信息>实际排查时按照固定顺序最省时间:先用 curl -V 看客户端能力,再用 %{http_version} 看最终协议,最后才使用 -v 深挖协商过程。这样可以避免在一个根本没有 HTTP/3 能力的 curl 上反复检查服务器或网络。