Java HttpClient使用HTTP/1.1时无法保持TCP长连接问题咨询

问题原因梳理 #

• Connection属于Java HttpClient的受限请求头，默认禁止用户手动配置，所以直接设置Connection: Keep-Alive会触发异常，该头会由HTTP客户端自动管理，无需手动设置。
• HTTP/1.1场景下长连接未生效基本都是客户端使用姿势问题，和默认配置无关：
  1. HttpClient的连接池绑定在实例维度，若每次请求都新建HttpClient实例，连接池不会复用，必然每次新建TCP连接。
  2. 响应体未被完整消费：若请求返回后没有读取完整的响应内容，客户端会判定连接不可复用，主动关闭TCP连接。
• HTTP/2因为是多路复用机制，只要复用客户端实例就会默认复用同一条TCP连接，所以你测试的HTTP/2场景符合预期。

正确配置&使用姿势 #

1. 全局复用同一个HttpClient实例，不要每次请求新建，示例：

// 全局初始化一次，所有请求复用该实例
private static final HttpClient HTTP_11_CLIENT = HttpClient.newBuilder()
        .version(HttpClient.Version.HTTP_1_1)
        .connectTimeout(Duration.ofSeconds(10))
        .build();

2. 每次请求必须完整消费响应体，哪怕不需要返回内容也要处理：

HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("http://localhost:8080/test"))
        .GET()
        .build();
// 方式1：直接接收字符串响应，自动消费完body
HttpResponse<String> response = HTTP_11_CLIENT.send(request, HttpResponse.BodyHandlers.ofString());
// 方式2：不需要响应内容时用discarding处理器，会自动读取并丢弃body，确保连接可复用
// HttpResponse<Void> response = HTTP_11_CLIENT.send(request, HttpResponse.BodyHandlers.discarding());

3. （可选）调整长连接参数：如果需要修改默认的长连接闲置超时、连接池大小，可以在JVM启动参数中添加如下配置：

# 长连接闲置超时时间，单位秒，默认30秒
-Djdk.httpclient.keepalive.timeout=60
# 连接池最大连接数，默认0代表无限制
-Djdk.httpclient.connectionPoolSize=32

按照以上配置修改后，多次请求会复用同一条TCP连接，符合预期。

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