OkHttp

OkHttp 简介

OkHttp 是一个面向 JVM、Android 和 GraalVM 的高效 HTTP 客户端。HTTP 是现代应用交换数据与媒体的基础，OkHttp 的目标是让网络请求更快、更省带宽。

默认就高效

• HTTP/2 支持：同一主机的多个请求可共享一个 socket。
• 连接池：在无法使用 HTTP/2 时降低请求延迟。
• 透明 GZIP：自动压缩下载体积。
• 响应缓存：重复请求可完全避免走网络。

网络不稳定时也能恢复

OkHttp 能从常见连接问题中静默恢复。若服务有多个 IP 地址，首次连接失败时会尝试备用地址，这对 IPv4+IPv6 及多数据中心部署很重要。它支持 TLS 1.3、ALPN、证书固定等现代 TLS 特性。

简单易用的 API

请求/响应 API 采用流式构建器与不可变设计，同时支持同步阻塞调用和带回调的异步调用。

OkHttpClient client = new OkHttpClient();

String run(String url) throws IOException {
  Request request = new Request.Builder()
      .url(url)
      .build();

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

发送 JSON 数据同样简洁：

public static final MediaType JSON = MediaType.get("application/json");

RequestBody body = RequestBody.create(json, JSON);
Request request = new Request.Builder()
    .url(url)
    .post(body)
    .build();

规范的 HTTP 实现

OkHttp 遵循 HTTP 语义（RFC 9110）、HTTP 缓存（RFC 9111）、HTTP/1.1（RFC 9112）、HTTP/2（RFC 9113）、WebSocket（RFC 6455）以及 SSE 等规范。在规范不明确处，它会参考主流浏览器和常见 HTTP 库的行为。

它有意避免过度可配置，例如不允许带 body 的 GET 请求，缓存也不是可替换的接口实现。

环境要求与依赖

• 支持 Android 5.0+（API 21+）和 Java 8+。
• 依赖 Okio 进行高性能 I/O，并依赖 Kotlin 标准库。
• 使用平台内置 TLS 实现；在 Java 平台也可选用 Conscrypt。

发布与测试

OkHttp 以 Kotlin Multiplatform 项目发布，Gradle 项目可直接引入：

implementation("com.squareup.okhttp3:okhttp:5.5.1")

同时提供 BOM 帮助统一版本。项目还内置 MockWebServer，用于测试 HTTP、HTTPS 和 HTTP/2 客户端：

testImplementation("com.squareup.okhttp3:mockwebserver3:5.5.1")

GraalVM 原生镜像

使用 GraalVM 构建原生镜像可自动工作，仓库中的 okcurl 模块提供了示例构建方式。