Java HttpClient 怎样复用连接并读取响应体

如果你想让 Java HttpClient 复用连接，关键不是额外打开一个“复用开关”，而是把同一个 HttpClient 实例复用于多次请求。Oracle 文档说明，一个客户端通常管理自己的连接池，并在条件满足时复用连接；不同 HttpClient 实例之间通常不共享连接池。

官方资料：https://docs.oracle.com/en/java/javase/26/docs/api/java.net.http/java/net/http/HttpClient.html

实际项目中，把 HttpClient 作为服务级或组件级依赖长期持有；每次请求新建 HttpRequest，并在 send 或 sendAsync 时明确指定 BodyHandler，就能把连接复用和响应体读取拆成两个清晰的生命周期。

先把连接池的归属放对位置

我在把旧的 HttpURLConnection 调用改成 HttpClient 时，最容易忽略的是客户端对象的生命周期。下面这种写法每次调用都新建客户端，虽然语法上没有问题，却让连接复用失去意义：

// 错误示例：每次请求都新建客户端，客户端之间通常不共享连接池
HttpClient client = HttpClient.newHttpClient();
HttpResponse response = client.send(request, BodyHandlers.ofString());

更合适的边界是让一个服务组件持有一个客户端。客户端本身是不可变的，可以安全地配置一次后发送多次请求；连接是否最终复用仍取决于协议协商、服务端和连接状态，不能把“同一客户端”理解成每次请求必然使用同一条 TCP 连接。

HttpRequest 负责一次请求，HttpClient 负责共享资源

HttpRequest 适合按调用创建。使用 Builder 设置 URI、方法和请求头，build 之后得到不可变请求。请求对象和客户端对象分开后，代码更容易表达“同一客户端发送不同资源地址”的关系：

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

// 客户端是可复用资源；连接超时只约束建立新连接的阶段
HttpClient client = HttpClient.newBuilder()
        .connectTimeout(Duration.ofSeconds(10))
        .build();

// 请求保存本次调用的 URI 和超时，不把客户端配置复制到每个请求里
HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://example.com/api/items"))
        .timeout(Duration.ofSeconds(20))
        .header("Accept", "application/json")
        .GET()
        .build();

这里的连接超时不是完整响应超时：如果连接已经从连接池复用，就不会再经历建立连接阶段；请求级 timeout 则用于限制这次请求的整体等待边界。两者应按业务需要分别设置。

用 BodyHandler 决定怎样读取响应体

每次 send 或 sendAsync 都必须提供 BodyHandler。文本接口可以使用 BodyHandlers.ofString()，它会把完整响应体读完后交给 HttpResponse；二进制内容则更适合 ofByteArray()，避免先按文本解码。

import static java.net.http.HttpResponse.BodyHandlers;

// BodyHandlers.ofString() 负责把完整响应体解码为 String
HttpResponse response = client.send(request, BodyHandlers.ofString());

// 先判断 HTTP 状态码，再使用已读取的正文
if (response.statusCode() >= 200 && response.statusCode() 

“读取响应体”与“请求成功”不是一回事：BodyHandler 决定怎样得到 body，statusCode 才表达 HTTP 层面的结果。4xx 或 5xx 的响应也可能有可读取的正文，是否抛出业务异常应由调用方决定。

同步、异步与关闭时机怎么选

同步调用的 send 会等待响应到达，适合本身就在工作线程中顺序处理的任务。需要并发发起多个请求时，可以用 sendAsync 获得 CompletableFuture>，但仍然复用同一个客户端：

// 异步调用立即返回 Future，完成后再读取状态码和正文
client.sendAsync(request, BodyHandlers.ofString())
        .thenApply(response -> {
            // 只在 2xx 时返回正文，其他状态交给异常分支
            if (response.statusCode() = 300) {
                throw new IllegalStateException("HTTP 状态码：" + response.statusCode());
            }
            return response.body();
        });

共享客户端不要在每个请求结束后立即 close()。如果客户端属于短生命周期批处理任务，才在所有同步或异步请求完成后关闭；常驻服务则应让应用关闭流程统一处理。过早关闭会拒绝新请求，也可能打断仍在收尾的异步操作。

几个容易混淆的边界

• 复用客户端不等于强制复用连接：连接池、协议版本、服务端响应和空闲状态都会影响最终选择。
• BodyHandler 不负责业务判定：它处理 body 的形态，状态码、重试和错误映射仍由调用方决定。
• String 不是所有响应的默认答案：下载文件、压缩包或签名内容应优先考虑字节或文件型处理器。
• 关闭要看所有权：谁创建并拥有短生命周期客户端，谁负责在任务完成后关闭；共享依赖不要由单次调用随意关闭。

常见问题

一个 HttpClient 能发送不同域名的请求吗？可以。请求的 URI、请求头和请求级超时属于 HttpRequest；客户端则承载共享配置和连接资源，但不同目标的连接仍按各自目的地管理。

为什么用了同一个客户端，连接数还是会变化？连接复用是条件性的。HTTP 协议版本、服务端是否允许持久连接、连接是否空闲过久以及并发量都会影响连接池行为，代码层面应保证客户端可复用，而不是假设固定连接数。

读取 body 后还要再关闭什么对象吗？使用 ofString 或 ofByteArray 时，响应体由 BodyHandler 收集到返回对象中，调用方重点管理 HttpClient 的整体生命周期；若使用文件、流式或自定义 BodySubscriber，则按对应 API 的资源约定处理。

简单记忆就是：HttpClient 复用共享连接资源，HttpRequest 描述一次请求，BodyHandler 决定响应体形态，statusCode 决定 HTTP 结果，close 则只放在真正的客户端生命周期边界上。