OKHttp 对 HTTP/2 多路复用提供了开箱即用的支持,无需手动编写复杂的协议逻辑,核心只需保证「服务端支持 HTTP/2」+「OKHttp 客户端启用 HTTP/2」,即可自动实现单个 TCP 连接上的多请求并发。以下是从「基础使用」到「进阶优化」的完整实现指南:
一、 核心前提(HTTP/2 多路复用的生效条件)
- 服务端必须支持 HTTP/2:
- 推荐使用 HTTPS(HTTP/2 官方推荐基于 TLS 部署,通过 ALPN 协议协商);
- 若用 HTTP 明文传输(非推荐),需服务端支持
h2c(HTTP/2 Cleartext)。
- OKHttp 版本要求:OKHttp 3.0+ 已支持 HTTP/2,建议使用 4.x 最新版(如 4.12.0+)。
- 客户端配置:OKHttp 默认启用 HTTP/2,无需额外开关(仅需确保未禁用)。
二、 基础实现:快速启用 HTTP/2 多路复用
步骤 1:添加依赖
在 build.gradle 中引入 OKHttp(以 Android 为例):
dependencies { // OKHttp 核心依赖(4.x 版本) implementation 'com.squareup.okhttp3:okhttp:4.12.0' // 可选:日志拦截器(调试用) implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0' }步骤 2:创建 OKHttp 客户端(默认启用 HTTP/2)
OKHttp 客户端默认开启 HTTP/2,只需创建标准客户端即可:
import okhttp3.OkHttpClient; import okhttp3.logging.HttpLoggingInterceptor; import java.util.concurrent.TimeUnit; // 1. 配置日志拦截器(调试时查看协议版本) HttpLoggingInterceptor loggingInterceptor = new HttpLoggingInterceptor(message -> { // 打印请求/响应信息,可查看是否使用 HTTP/2 System.out.println("OKHttp Log: " + message); }); loggingInterceptor.setLevel(HttpLoggingInterceptor.Level.HEADERS); // 打印头信息(含协议版本) // 2. 创建 OkHttpClient(默认启用 HTTP/2) OkHttpClient client = new OkHttpClient.Builder() .connectTimeout(10, TimeUnit.SECONDS) .readTimeout(10, TimeUnit.SECONDS) .writeTimeout(10, TimeUnit.SECONDS) // 可选:强制启用 HTTP/2(默认已启用,无需配置) // .protocols(Collections.singletonList(Protocol.HTTP_2)) // 可选:禁用 HTTP/1.1(仅保留 HTTP/2)