Nginx：http2相关指令与large_client_header_buffers区别及日志消除咨询

能否消除该警告？ #

可以消除。这个警告是因为http2_max_header_size指令在新版本Nginx中已被废弃，改用large_client_header_buffers指令替代。只要把旧的废弃指令替换成新指令，重启Nginx后警告就会消失。

配置替换方法 #

你当前的配置是：

http2_max_field_size 16k;
http2_max_header_size 64k;

替换成large_client_header_buffers的话，需遵循其语法：large_client_header_buffers <缓冲区数量> <单个缓冲区大小>;。对应你的配置需求，推荐设置为：

large_client_header_buffers 4 16k;

逻辑说明：原http2_max_header_size限制总头大小64k，http2_max_field_size限制单个字段16k。新配置中，单个缓冲区大小16k覆盖单字段限制，4个缓冲区总大小（4×16k=64k）匹配原总头大小限制。

替换后删除原来的两行废弃指令，执行nginx -t验证配置正确性，确认无误后重启Nginx即可。

http2_max_field_size 与 large_client_header_buffers 的区别 #

• 适用范围：
  • http2_max_field_size和http2_max_header_size是HTTP/2专属指令，仅作用于HTTP/2请求；
  • large_client_header_buffers是通用指令，同时支持HTTP/1.x和HTTP/2请求，是Nginx统一处理大请求头的标准方式。
• 控制逻辑：
  • http2_max_field_size单独限制单个HTTP/2头字段的最大大小，http2_max_header_size限制所有头字段的总大小；
  • large_client_header_buffers通过「缓冲区数量×单个缓冲区大小」控制总头大小，同时单个缓冲区的大小也间接限制了单个头字段的最大大小（单个字段不能超过一个缓冲区的容量）。
• 版本生命周期：
  • http2_max_field_size和http2_max_header_size已被废弃，新版本Nginx不再推荐使用；
  • large_client_header_buffers是长期维护的指令，后续版本会持续支持。

内容的提问来源于stack exchange，提问作者Glitch