确认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 解密。
立即学习“C++免费学习笔记（深入）”；
- 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，而你连日志都没开。
