升级Spring Boot后Jetty HTTP客户端抛出“request headers too large”的原因

• Jetty依赖版本的默认配置变更
  Spring Boot升级会同步更新其依赖的Jetty版本。Jetty 11及后续版本中，默认的请求头最大容量从之前的8KB（或更高值）调整为4KB。如果你的请求头总大小超过了这个新阈值，就会触发该错误。

• Spring Boot自动配置的调整
  部分Spring Boot新版本优化了Jetty客户端的自动配置逻辑，移除了之前默认放宽头大小限制的隐式设置。旧版本中Spring Boot可能帮你默认设置了更大的头容量，升级后该配置不再生效，导致Jetty启用了更严格的默认限制。

• 请求头内容的隐性变化
  即便你认为请求逻辑没改，升级过程中可能引入了其他依赖或配置变更，间接导致请求头内容增加（比如新增链路追踪头、扩展认证头），刚好触及了Jetty新的默认上限。

解决建议 #

• 显式配置头大小限制
  在Spring Boot的application.properties或application.yml中添加配置：

  # 将请求头最大大小设置为16KB（可根据实际需求调整）
  spring.jetty.max-http-header-size=16384
  

  或者通过Java配置类自定义Jetty客户端实例：

  @Bean
  public JettyHttpClient customJettyHttpClient() {
      HttpClient jettyClient = new HttpClient();
      // 设置请求和响应的缓冲区大小，对应头容量限制
      jettyClient.setRequestBufferSize(16384);
      jettyClient.setResponseBufferSize(16384);
      return new JettyHttpClient(jettyClient);
  }
  

• 精简请求头内容
  排查请求中是否存在冗余的头字段，或近期新增的非必要头信息，通过精简来适配默认限制。

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