如何在Quarkus/Vert.x中增大HTTP/2头部大小限制？

Quarkus HTTP/2 配置参数说明 #

Quarkus提供以下四个HTTP/2相关配置参数：

• quarkus.http.limits.header-table-size
• quarkus.http.limits.max-concurrent-streams
• quarkus.http.limits.max-frame-size
• quarkus.http.limits.max-header-list-size

这些参数的计量单位为octets（字节），Quarkus底层基于Vert.x服务器，若尝试增大quarkus.http.limits.max-header-list-size后效果不佳，可参考以下问题解答：

1. 如何通过HTTP/2协议增大头部大小？ #

HTTP/2头部大小受两个核心参数控制，需配合调整：

1. 核心控制：quarkus.http.limits.max-header-list-size
   这是直接限制头部列表总大小的参数，需确保正确配置在application.properties中，示例：

   quarkus.http.limits.max-header-list-size=65536
   

   若调整后无效，需排查：
   • 客户端或反向代理（如Nginx、HAProxy）是否存在独立的HTTP/2头部大小限制，需同步调整；
   • Quarkus与底层Vert.x版本是否兼容，避免版本差异导致配置不生效。
2. 辅助优化：quarkus.http.limits.header-table-size
   该参数控制HPACK头部压缩表的大小，增大它可提升重复头部字段的压缩效率，但不直接允许更大的头部总大小，仅在头部可被有效压缩时减少传输字节数。
3. 间接关联：quarkus.http.limits.max-frame-size
   头部会拆分为多个帧传输，只要max-header-list-size足够大，多帧传输是被允许的，避免将该参数设置过小导致帧拆分异常即可。

2. 这些配置参数之间的相互影响？ #

四个参数的作用与关联逻辑如下：

• header-table-size：影响HPACK压缩效率，压缩表越大，重复头部的压缩率越高，但会占用更多内存。它不直接限制头部总大小，但压缩后的头部仍需满足max-header-list-size的限制。
• max-concurrent-streams：控制单连接下的并发流数量，与头部大小无直接关联，但高并发+大头部场景下，会增加内存占用，需配合调整max-header-list-size避免内存溢出。
• max-frame-size：单个HTTP/2帧的最大字节数，仅影响头部传输的分帧数量，不限制头部总大小。过小的帧大小会增加传输开销，建议保持默认或适度调整。
• max-header-list-size：直接限制单请求/响应的头部总字节数（压缩前），是控制头部大小的核心参数，超过该值的请求会被服务器拒绝。

3. 如何将字节值转换为当前配置参数的取值？ #

所有参数的计量单位均为字节（1 octet = 1 byte），直接使用字节数值作为参数值即可：

• 例如设置为64KB：计算64 * 1024 = 65536，配置为quarkus.http.limits.max-header-list-size=65536；
• 例如设置为1MB：计算1024 * 1024 = 1048576，直接填写对应整数即可；
• 注意：Quarkus不支持64k这类简化写法，需输入计算后的整数数值。

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