适用条件:先确认是不是这个问题

适用于 curl 已连接到站点,但提示 HTTP/2 流或帧相关错误。先记录原错误再做协议对照,不把握手失败、证书错误或 HTTP 403 都归为 HTTP/2 不兼容。

为什么会出现这种现象

curl 可以对 HTTP 请求指定协议偏好;HTTPS 上的 --http2 会参与协商,不保证最终一定使用 HTTP/2。请求目标与 HTTPS 代理本身还可能处于不同的 HTTP 协议层,需要看实际协商结果。

按顺序操作,每次只改一项

  1. 运行 curl --version,记录版本与 Features,确认构建支持 HTTP2。若选项本身不被支持,应先解决客户端能力问题,不把命令报错算成站点拒绝 HTTP/2。
  2. 选择一个公开小页面,固定节点、目标和显式代理端口。下方命令面向 macOS/Linux,7890 只是本地 HTTP/mixed 端口示例;不要测试支付或带副作用的接口。
  3. 分别执行 HTTP/1.1 和 HTTP/2 的单次请求,比较退出码、HTTP 状态和 http_version。两条都显示 1.1 时,没有完成真正的 HTTP/2 对照,不能声称 HTTP/2 已通过。
  4. 若相同条件下只有协商到 HTTP/2 的请求失败,记录完整错误和时间交给维护者继续查。显式代理仍需沿用原路径,不用直连成功来替代代理路径的结果。
macOS/Linux 单次 GET 对照;替换为实际本地代理端口
curl -q --proxy "http://127.0.0.1:7890" --noproxy "" --http1.1 --max-time 15 -o /dev/null -w "http=%{http_version} status=%{http_code}\n" "https://example.com/"
curl -q --proxy "http://127.0.0.1:7890" --noproxy "" --http2 --max-time 15 -o /dev/null -w "http=%{http_version} status=%{http_code}\n" "https://example.com/"

怎样判断已经修好

HTTP/1.1 可用只提供协议相关的定位线索,不足以断言是站点、CDN 还是代理一方有缺陷。HTTP 状态和命令退出码要一起看;返回错误页面但传输完成,也不能称业务功能已恢复。

没修好时如何恢复与继续排查

移除临时协议参数就恢复默认协商。需要临时固定 HTTP/1.1 时仅限定在受影响请求,不建议直接永久关闭浏览器的 HTTP/2,更不能通过 --insecure 让本来无关的证书错误消失。