如何让Feign集成的OKHttpClient强制使用HTTP/2协议？

已使用OKHttp搭建基础HTTP/2客户端，目标服务https://http2.pro/api/v1已启用HTTP/2。配置FeignClient及相关参数后，调用服务时日志显示使用HTTP/1.1协议。尝试通过H2_PRIOR_KNOWLEDGE配置时出现报错：'H2_PRIOR_KNOWLEDGE cannot be used with HTTPS'，如何强制客户端使用HTTP/2协议？

相关代码与配置 #

FeignClient定义 #

@FeignClient(name = "client", url = "https://http2.pro/api/v1", configuration = FeignConfig.class)
public interface TestClient {
    @GetMapping("/")
    String callServer();
}

配置文件 #

feign.client.config.default.logger-level=full
feign.okhttp.enabled=true
logging.level.com.example=DEBUG
logging.level.okhttp3=DEBUG

部分日志 #

om.example.http2clientpoc.TestClient    : [TestClient#callServer] ---> GET https://http2.pro/api/v1/ HTTP/1.1
2023-02-07 12:42:53.704 DEBUG 53855 --- [           main] com.example.http2clientpoc.TestClient    : [TestClient#callServer] ---> END HTTP (0-byte body)
2023-02-07 12:42:54.080 DEBUG 53855 --- [           main] okhttp3.internal.http2.Http2             : >> CONNECTION 505249202a20485454502f322e300d0a0d0a534d0d0a0d0a
2023-02-07 12:42:54.081 DEBUG 53855 --- [           main] okhttp3.internal.http2.Http2             : >> 0x00000000     6 SETTINGS      
2023-02-07 12:42:54.081 DEBUG 53855 --- [           main] okhttp3.internal.http2.Http2             : >> 0x00000000     4 WINDOW_UPDATE 

报错代码及信息 #

尝试配置OkHttpClient时使用H2_PRIOR_KNOWLEDGE：

@Bean
OkHttpClient httpClient() {
   return new OkHttpClient(new okhttp3.OkHttpClient.Builder()
        .protocols(List.of(Protocol.H2_PRIOR_KNOWLEDGE)).build());
}

报错信息：'H2_PRIOR_KNOWLEDGE cannot be used with HTTPS'

核心原因 #

H2_PRIOR_KNOWLEDGE仅适用于明文HTTP场景，用于跳过TLS握手直接使用HTTP/2。而HTTPS场景下，HTTP/2的启用依赖ALPN（应用层协议协商），通过TLS握手阶段确定使用HTTP/2还是HTTP/1.1，因此直接指定H2_PRIOR_KNOWLEDGE会触发错误。

正确配置步骤 #

• 配置OkHttpClient支持HTTP/2协议
  修改OkHttpClient的协议列表，包含HTTP_2和HTTP_1_1，让OKHttp通过ALPN自动协商使用HTTP/2：

  @Configuration
  public class FeignConfig {
      @Bean
      public OkHttpClient okHttpClient() {
          return new okhttp3.OkHttpClient.Builder()
                  .protocols(List.of(Protocol.HTTP_2, Protocol.HTTP_1_1))
                  .build();
      }
  }
  

  关键：使用Protocol.HTTP_2而非H2_PRIOR_KNOWLEDGE。

• 确保Feign加载自定义客户端
  确认FeignConfig类被Spring容器扫描到（添加@Configuration注解），且FeignClient的configuration属性指向该类，保证Feign使用我们配置的OkHttpClient。

• 验证HTTP/2生效

  • 查看OKHttp日志，若请求行显示HTTP/2.0，或出现HTTP/2相关的帧日志（如SETTINGS、WINDOW_UPDATE），说明协商成功。
  • 调用https://http2.pro/api/v1后，返回的JSON中http2字段值为1，则表示已使用HTTP/2协议。

额外注意点 #

• 确保OKHttp版本≥3.7.0（该版本开始支持HTTP/2）。
• 客户端TLS版本需符合服务端要求（通常需TLS 1.2及以上），否则ALPN协商可能失败回退到HTTP/1.1。

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