张超:又拍云系统开发高级工程师,负责又拍云 CDN 平台相关组件的更新及维护。Github ID: tokers,活跃于 OpenResty 社区和 Nginx 邮件列表等开源社区,专注于服务端技术的研究;曾为 ngx_lua 贡献源码,在 Nginx、ngx_lua、CDN 性能优化、日志优化方面有较为深入的研究。

众所周知,HTTP/2 使用了 HPACK 来压缩头部,通过使用索引替代原始的文本来减少传输的字节数。HPACK 维护了两张表,一张称为静态表,由 RFC/7541 给出定义,包含了许多 HTTP 协议里常见的头部名和值;另外一张则是动态表,可以由客户端、服务端控制新的头部字段。

dynamic table size update

出于控制单连接资源消耗的目的, 协议允许连接两端控制这张动态表的大小。

第一种方式是通过 HTTP/2 的 SETTINGS 帧进行通告:

SETTINGS_HEADER_TABLE_SIZE (0x1): Allows the sender to inform the remote endpoint of the maximum size of the header compression table used to decode header blocks, in octets. The encoder can select any size equal to or less than this value by using signaling specific to the header compression format inside a header block (see [COMPRESSION]). The initial value is 4,096 octets.

第二种是在第一个 HEADERS 帧数据里进行控制。

A change in the maximum size of the dynamic table is signaled via a dynamic table size update (see Section 6.3). This dynamic table size update MUST occur at the beginning of the first header block following the change to the dynamic table size. In HTTP/2, this follows a settings acknowledgment (see Section 6.5.3 of [HTTP2]).


Nginx 的相关实现

Nginx/1.13.6 引入了一个新特性,在一条连接第一次向对端发送 HEADERS 帧时,就会用到上述第二种方式,要求对端把动态表清空。

这个新特性导致了一些对 HTTP/2 实现不完整的客户端无法正常工作,例如一些 okhttp 的旧版本就会发出这样的错误:

ProtocolException: Expected ':status' header not present

这里 :status header 等价于 HTTP/1.x 状态行里的状态码(因为 HTTP/2 将请求行、状态行的字段都用伪头部进行表示了,因此也称为 header)。

究其根本就是这些客户端在解析 HEADERS 帧的时候,没有把 dynamic table size update 这种特性考虑进来,于是导致了协议解析失败。

笔者就曾在公司的测试机器上遇到过这个问题,Nginx 并没有把这个特性做成可配置的(很大程度上是因为这是协议里明确规定的),后来也只能 revert 了那个提交。


《我眼中的 Nginx》专栏:

我眼中的 Nginx(一):Nginx 和位运算