C++如何调用HTTP/2接口？（nghttp2或libcurl启用HTTP2）

确认libcurl是否启用http/2需先检查curl –version输出含“http2”及nghttp2版本；编译须链接nghttp2，windows用vcpkg需显式安装curl[http2,ssl]；运行时应设curlopt_http_version为curl_http_version_2tls并开启ssl验证。

确认 libcurl 是否真正启用了 HTTP/2

很多开发者以为装了 libcurl 并传了 CURLOPT_HTTP_VERSION 就能用 HTTP/2，结果抓包发现还是 HTTP/1.1——根本原因是底层没编译进 HTTP/2 支持。libcurl 默认不带 nghttp2，必须显式链接并启用。

• 检查方式：运行 curl --version，输出里必须含 HTTP2（不是 HTTP/2），且后面跟着 nghttp2 版本号
• 若没有，重新编译 libcurl 时得加 --with-nghttp2=/path/to/nghttp2，确保 nghttp2 头文件和库可被找到
• Windows 下用 vcpkg 安装需显式指定 curl[http2,ssl]，否则默认关掉 HTTP/2
• 即使编译对了，运行时仍可能 fallback 到 HTTP/1.1：服务端不支持 ALPN、证书链不完整、或用了 HTTP/2 over TCP（非 TLS）但服务端拒绝 —— 这类情况 libcurl 不报错，只静默降级

用 CURLOPT_HTTP_VERSION 正确触发 HTTP/2

CURLOPT_HTTP_VERSION 的取值容易误解：设成 CURL_HTTP_VERSION_2_0 并不强制协议，只是“允许使用 HTTP/2”，实际是否启用由 ALPN 协商决定；而 CURL_HTTP_VERSION_2TLS 才是推荐写法，它明确要求 TLS + ALPN + HTTP/2，避免明文 HTTP/2（即 h2c）这种服务端普遍不支持的模式。

• 别用 CURL_HTTP_VERSION_2（已废弃）或 CURL_HTTP_VERSION_2_0（太宽松，易 fallback）
• 务必搭配 CURLOPT_SSL_VERIFYPEER 和 CURLOPT_SSL_VERIFYHOST 设为 1L，否则 ALPN 协商失败，HTTP/2 直接不可用
• 如果服务端只支持 h2c（如本地测试的 nghttpx），需额外设 CURLOPT_HTTP_VERSION 为 CURL_HTTP_VERSION_2_PRIOR_KNOWLEDGE，并关闭 TLS 相关选项 —— 但生产环境几乎不用

nghttp2 底层调用时绕不开的连接复用陷阱

直接用 nghttp2 C API 而不是 libcurl 时，nghttp2_session_send() 和 nghttp2_session_recv() 的调用节奏极易出错：一次 send 后没等 recv 完就又 send，或 recv 返回 0 但没检查 nghttp2_session_want_read()/want_write()，导致连接卡死或 stream 重置。

• 必须严格按事件循环节奏驱动：每次 socket 可读就调 nghttp2_session_recv()，直到返回 nghttp2_session_send()，直到返回 0
• 不要自己拼 HTTP/2 帧；所有 stream 创建、HEADERS、DATA 都走 nghttp2_submit_* 系列函数，让库管理流控和优先级
• 设置 NGHTTP2_SETTINGS_ENABLE_PUSH 为 0，否则某些服务端（如 Cloudflare）会因不支持推送而直接 RST_STREAM
• 记得调 nghttp2_session_set_user_data() 绑定自定义上下文，否则回调里拿不到 request/response 对象

抓包验证 HTTP/2 是否生效的关键信号

光看 curl 返回码或响应头不够，HTTP/2 的帧结构、流 ID、HPACK 压缩都得靠抓包确认。Wireshark 是唯一靠谱手段，但默认不解析 HTTP/2，需要提前配置 TLS 解密。

• Wireshark 中过滤 http2，看到 HEADERS、DATA、SETTINGS 帧才算真跑起来了
• 关键线索：响应头里没有 Connection: keep-alive，也没有 Transfer-Encoding；所有 header 都在 HEADERS 帧里，且 key 全小写（HPACK 编码所致）
• 如果看到大量 REFUSED_STREAM 或 INTERNAL_ERROR，大概率是 client 设置了不兼容的 SETTINGS（比如 INITIAL_WINDOW_SIZE 设太大）
• macOS 上用 curl -v https://example.com 时，开头那行 * Using HTTP2, server supports multi-use 是最简验证，但仅限 libcurl 场景

HTTP/2 不是开关一开就通的协议，ALPN 协商、TLS 配置、服务端策略、帧流控，任何一环松动都会静默退化。最常被忽略的是：你以为在发 HTTP/2，其实 curl 正在 fallback，而你连日志都没开。