当前位置：首页 > news >正文

实用指南：12_OkHttp初体验

news 2026/6/11 19:21:19

实用指南：12_OkHttp初体验

12_OkHttp初体验

在 Java 开发中，网络请求是非常常见的需求。除了 Spring 自带的 RestTemplate 和 WebClient，一个非常轻量级、性能强劲的 HTTP 客户端库就是 OkHttp。
今天就来记录一下我在 Spring Boot 项目中集成并使用 OkHttp 的初体验。

一、OkHttp 配置类

首先在 Spring Boot 中，我们通常会将 OkHttpClient 配置成一个 Bean，方便全局注入使用。

/**
* @Author: sqnugy
* @Date: 2025/7/29 20:13
* @Version: v1.0.0
* @Description: OkHttp 客户端配置类
**/
@Configuration
public class OkHttpConfig {
@Bean
public OkHttpClient okHttpClient(
@Value("${okhttp.connect-timeout}") int connectTimeout,
@Value("${okhttp.read-timeout}") int readTimeout,
@Value("${okhttp.write-timeout}") int writeTimeout,
@Value("${okhttp.max-idle-connections}") int maxIdleConnections,
@Value("${okhttp.keep-alive-duration}") int keepAliveDuration) {
return new OkHttpClient.Builder()
.connectTimeout(connectTimeout, TimeUnit.MILLISECONDS) // 建立连接超时
.readTimeout(readTimeout, TimeUnit.MILLISECONDS)       // 读取数据超时
.writeTimeout(writeTimeout, TimeUnit.MILLISECONDS)     // 写入数据超时
.connectionPool(new ConnectionPool(maxIdleConnections, keepAliveDuration, TimeUnit.MINUTES)) // 连接池配置
.build();
}
}

这样一来，OkHttpClient 就能作为 Spring Bean 被注入使用啦

⚙️ 二、配置文件

为了灵活性，我们把超时时间、连接池参数等写到 application.yml 中：

okhttp: # OkHttp 客户端配置
connect-timeout: 5000    # 建立连接的最大等待时间（毫秒）
read-timeout: 30000      # 读取数据的最大等待时间（毫秒）
write-timeout: 15000     # 写入数据的最大等待时间（毫秒）
max-idle-connections: 200 # 连接池中保持的最大空闲连接数
keep-alive-duration: 5   # 空闲连接在连接池中的存活时间（分钟）

这样后续如果需要调整参数，就不需要改代码了，非常方便。

三、OkHttp 使用示例

以一个 同步 GET 请求为例，我们来抓取指定 URL 的 HTML 内容。

/**
* 同步获取指定 URL 的 HTML 内容
* @param url 请求地址
* @return 页面 HTML 字符串
*/
private String syncFetchHtmlContent(String url) {
// 构建 HTTP GET 请求
Request request = new Request.Builder()
.url(url)
.header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36") // 模拟浏览器 UA
.header("Accept", "text/html")  // 接受 HTML 格式
.build();
try (Response response = okHttpClient.newCall(request).execute()) {
// 判断响应是否成功
if (!response.isSuccessful() || response.body() == null) {
return "";
}
// 返回响应内容
return response.body().string();
} catch (IOException e) {
e.printStackTrace();
return "";
}
}