确认底层库是否真正启用HTTP/2支持需检查ALPN协商、TLS握手是否携带h2标识；Nginx须配ssl_protocols TLSv1.2+和listen 443 ssl http2；OpenSSL服务端须调用SSL_CTX_set_alpn_protos()注册"h2"；证书链须完整，否则libcurl等会静默降级至HTTP/1.1。
确认底层库是否真正启用 HTTP/2 支持
很多 C++ 服务端项目用 libcurl 或 nghttp2 做客户端调用，但服务端支持 HTTP/2 不是“编译进去了”就等于“跑起来了”。关键看运行时是否完成 ALPN 协商、TLS 握手是否携带 h2 协议标识。
常见错误现象：curl --version 显示 HTTP2，但用它请求你的服务端，Wireshark 抓包仍是 HTTP/1.1；或者服务端日志里没有 SETTINGS 帧收发记录。
- 检查服务端 TLS 层是否启用 ALPN：Nginx 需配置
ssl_protocols TLSv1.2 TLSv1.3;和http2指令；自研服务若基于 OpenSSL，必须调用SSL_CTX_set_alpn_protos()注册"h2"（注意字节序前缀） - 禁用不安全的降级路径：避免在生产环境使用
http2_direct或h2c（HTTP/2 over TCP），绝大多数 CDN 和浏览器只认h2（即 TLS + ALPN） - 证书链要完整：ALPN 协商失败时，libcurl 等库会静默 fallback 到 HTTP/1.1，不报错也不警告
HPACK 压缩不是开关选项，而是协议强制行为
HTTP/2 规范要求所有头部字段必须经 HPACK 编码传输，服务端无需“开启压缩”，但必须正确维护静态表（static table）和动态表（dynamic table）状态。出问题往往不是压得不够，而是表同步错乱或内存失控。
典型表现：同一域名下多个并发请求的 Cookie 或 User-Agent 头部体积忽大忽小；某些 stream 响应头突然膨胀到几 KB；服务端 OOM（尤其在高并发短连接场景）。
立即学习“C++免费学习笔记（深入）”；
- 动态表大小受
SETTINGS_HEADER_TABLE_SIZE控制，服务端需响应客户端的SETTINGS帧并更新本地限值，不能硬编码为固定值 - 不要复用同一个
nghttp2_session实例处理多个 TLS 连接：HPACK 表是 per-connection 的，跨连接共享会导致解码失败或崩溃 - 若自己实现 HPACK（如基于 libuv 的轻量框架），优先复用静态表索引（如
:method: GET对应索引 2），避免对高频字段反复编码字符串
多路复用生效的前提是连接不被提前关闭
HTTP/2 的多路复用依赖长连接维持多个 active stream，但很多 C++ 服务端默认沿用 HTTP/1.1 的连接管理逻辑：比如收到一个请求就 close() socket，或对每个请求新建线程后忘记回收连接上下文。
结果就是：协议层支持了 HTTP/2，但实际每个请求仍独占一个 TCP 连接，完全浪费多路复用能力。
- 确保连接生命周期由事件循环统一管理，而非 handler 函数内自行
shutdown()/close() - 设置合理的
SETTINGS_MAX_CONCURRENT_STREAMS（如 Nginx 默认 128），太小会阻塞新 stream，太大可能压垮后端线程池 - 注意流控窗口（flow control window）：发送
DATA帧前必须检查nghttp2_session_get_stream_effective_recv_window_size()，否则对方可能因窗口为 0 而 RST_STREAM - 不要在 stream 关闭后继续往该 stream ID 写数据，
nghttp2会返回NGHTTP2_ERR_STREAM_CLOSED，但容易被忽略导致后续帧错位
调试时别只盯响应体，重点看帧层交互
HTTP/2 错误很少暴露在应用层（比如返回 500），更多体现为连接中断、stream 重置、或延迟毛刺。这时候靠打印 request.path 或 response.status 没用，得下探到帧层。
推荐做法：在 nghttp2_on_frame_recv_callback 和 nghttp2_on_stream_close_callback 里加日志，过滤出 NGHTTP2_RST_STREAM、NGHTTP2_GOAWAY、NGHTTP2_SETTINGS 等关键帧类型。
- 出现
RST_STREAM且 error_code =PROTOCOL_ERROR：大概率是帧顺序错乱（比如先发HEADERS后发SETTINGS）或非法 stream ID -
GOAWAY帧带ENHANCE_YOUR_CALM：说明对方认为你违反了流量控制，检查是否未及时调用nghttp2_session_consume() - 抓包看到大量
PING帧无响应：可能是事件循环卡住，没及时处理 socket 可读事件，导致nghttp2_session_recv()没被调用
最易被忽略的一点：HPACK 解码失败不会触发应用层回调，只会让整个 stream 被静默 RST —— 所以帧日志里看不到错误，但客户端收不到响应。
