HttpClient、OkHttp 和 WebClient

HttpClient、OkHttp 和 WebClient 是 Java 生态中常见的 HTTP 客户端，它们在设计理念、异步能力、性能等方面有所不同。以下是它们的详细对比：

1. 概述

客户端	介绍
Apache HttpClient	传统同步 HTTP 客户端，功能丰富，历史悠久，适用于需要高度定制的 HTTP 交互。
OkHttp	现代化 HTTP 客户端，支持同步和异步请求，轻量高效，广泛用于 Android 和 Java。
WebClient	Spring 5 引入的响应式 HTTP 客户端，基于 `Reactor` ，适用于高并发异步场景。

2. 主要特点对比

特性	Apache HttpClient	OkHttp	WebClient
是否支持同步	✅ 是	✅ 是	🚫 否（默认异步，但可 `block()` ）
是否支持异步	⚠️ 通过 `HttpAsyncClient`	✅ 是（基于 `Callback` 或 `Future` ）	✅ 是（基于 `Reactor` ，更高效）
连接池管理	✅ 手动配置	✅ 内置	✅ 内置，支持 `ConnectionProvider`
流式处理	⚠️ 支持 `InputStream`	✅ 原生支持	✅ 完全基于 `Flux` /`Mono`
拦截器支持	✅ 是	✅ 是	✅ 是（`ExchangeFilterFunction` ）
超时控制	✅ 可配置	✅ 可配置	✅ 可配置
WebSocket 支持	⚠️ 需要额外实现	✅ 支持	✅ 内置支持
适用场景	适用于同步请求或传统应用	适用于高效 HTTP 访问，Android 领域广泛使用	适用于高并发、非阻塞、微服务架构

3. 使用示例对比

（1）Apache HttpClient

java 复制代码

CloseableHttpClient client = HttpClients.createDefault();
HttpGet request = new HttpGet("https://api.example.com/data");

try (CloseableHttpResponse response = client.execute(request)) {
    HttpEntity entity = response.getEntity();
    if (entity != null) {
        String result = EntityUtils.toString(entity);
        System.out.println(result);
    }
}

优缺点：

优点：功能丰富，成熟稳定，适合复杂需求。
缺点：默认是同步的，异步需要 HttpAsyncClient，API 使用较复杂。

（2）OkHttp

java 复制代码

OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
        .url("https://api.example.com/data")
        .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

异步请求：

java 复制代码

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onResponse(Call call, Response response) throws IOException {
        System.out.println(response.body().string());
    }

    @Override
    public void onFailure(Call call, IOException e) {
        e.printStackTrace();
    }
});

优缺点：

优点：API 简洁，支持同步和异步，轻量高效。
缺点：异步采用 Callback，嵌套过深时可能会导致代码复杂。

（3）WebClient

java 复制代码

WebClient webClient = WebClient.create();

String response = webClient.get()
    .uri("https://api.example.com/data")
    .retrieve()
    .bodyToMono(String.class)
    .block();

System.out.println(response);

异步方式：

java 复制代码

webClient.get()
    .uri("https://api.example.com/data")
    .retrieve()
    .bodyToMono(String.class)
    .subscribe(System.out::println);

优缺点：

优点：完全异步、非阻塞，适用于 WebFlux、高并发场景。
缺点：有一定的学习成本，依赖 Reactor，不适用于传统同步应用。

4. 适用场景

场景	推荐客户端
传统同步 HTTP 请求	Apache HttpClient / OkHttp
高效异步请求	OkHttp
响应式编程 / 高并发微服务	WebClient
需要 WebSocket 支持	OkHttp / WebClient
需要复杂 HTTP 代理、认证、拦截器	Apache HttpClient

5. 总结

如果是传统应用或同步请求，使用 **Apache HttpClient** 或 **OkHttp**。
如果追求高效异步， **OkHttp**** 是更现代的选择。**
如果是 **Spring WebFlux** 应用， **WebClient**** 是首选，尤其适用于高并发和 **Reactor** 生态。**