《OkHttp：工作原理 拦截器链深度解析》

目录

一、OKHttp 的基本使用

1. 添加依赖

2. 发起 HTTP 请求

3. 拦截器（Interceptor）

4. 高级配置

二、OKHttp 核心原理

1. 责任链模式（Interceptor Chain）

2. 连接池（ConnectionPool）

3. 请求调度（Dispatcher）

4. 缓存机制

5. 其他特性

三、拦截器工作原理

3.1 拦截器链的执行顺序

3.2 五大拦截器的工作原理

3.3 拦截器协作流程图

3.4 关键场景分析

3.5 总结

四、常见问题与优化

五、总结

OKHttp 是一款高效的 HTTP 客户端库，由 Square 公司开发，支持 Android 和 Java 应用。它简化了 HTTP 请求处理，支持同步/异步请求、连接池、缓存、拦截器等特性。以下是其使用流程图和原理的详细解析：

一、OKHttp 的基本使用

1. 添加依赖

在 Gradle 中添加依赖：

implementation 'com.squareup.okhttp3:okhttp:4.9.3' // 最新版本以官方为准
2. 发起 HTTP 请求

同步请求示例：

OkHttpClient client = new OkHttpClient();

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

try (Response response = client.newCall(request).execute()) {
    if (response.isSuccessful()) {
        String responseData = response.body().string();
        System.out.println(responseData);
    }
} catch (IOException e) {
    e.printStackTrace();
}

注意： 同步请求需在子线程执行（Android 中主线程禁止网络操作）。

异步请求示例：

client.newCall(request).enqueue(new Callback() {
    @Override
    public void onFailure(Call call, IOException e) {
        e.printStackTrace();
    }

    @Override
    public void onResponse(Call call, Response response) throws IOException {
        if (response.isSuccessful()) {
            String responseData = response.body().string();
            // 注意：回调在后台线程，需切换线程更新 UI
        }
    }
});
3. 拦截器（Interceptor）

拦截器用于监控、修改请求和响应。例如添加统一请求头：

OkHttpClient client = new OkHttpClient.Builder()
    .addInterceptor(new Interceptor() {
        @Override
        public Response intercept(Chain chain) throws IOException {
            Request originalRequest = chain.request();
            Request newRequest = originalRequest.newBuilder()
                .header("Authorization", "Bearer token")
                .build();
            return chain.proceed(newRequest);
        }
    })
    .build();
4. 高级配置
OkHttpClient client = new OkHttpClient.Builder()
    .connectTimeout(10, TimeUnit.SECONDS) // 连接超时
    .readTimeout(30, TimeUnit.SECONDS)    // 读取超时
    .writeTimeout(30, TimeUnit.SECONDS)   // 写入超时
    .cookieJar(new CookieJar() {          // Cookie 管理
        private final HashMap<HttpUrl, List<Cookie>> cookieStore = new HashMap<>();
        @Override
        public void saveFromResponse(HttpUrl url, List<Cookie> cookies) {
            cookieStore.put(url, cookies);
        }
        @Override
        public List<Cookie> loadForRequest(HttpUrl url) {
            return cookieStore.getOrDefault(url, new ArrayList<>());
        }
    })
    .build();

二、OKHttp 核心原理

1. 责任链模式（Interceptor Chain）

OKHttp 的核心是 拦截器链，每个请求会依次经过多个拦截器处理：

  • 自定义拦截器：开发者添加的拦截器，最先执行。

  • RetryAndFollowUpInterceptor：处理重定向和失败重试。

  • BridgeInterceptor：补全请求头（如 Content-Type、Cookie）。

  • CacheInterceptor：根据缓存策略返回缓存或请求网络。

  • ConnectInterceptor：建立与服务器的连接（复用连接池中的连接）。

  • CallServerInterceptor：向服务器发送请求并读取响应。

2. 连接池（ConnectionPool）

  • 作用：复用 TCP 连接，减少握手开销。

  • 默认配置：最大空闲连接数 5，存活时间 5 分钟。

  • 实现：通过 RealConnectionPool 管理空闲连接，清理过期连接。

3. 请求调度（Dispatcher）

  • 同步请求：直接执行，但需开发者自行管理线程。

  • 异步请求：通过 Dispatcher 管理线程池，默认最大并发请求数 64，单个域名最大并发 5。

4. 缓存机制

  • 基于 HTTP 缓存协议（如 Cache-Control、ETag）。

  • 缓存目录需开发者指定，通过 Cache 类配置：

    Cache cache = new Cache(context.getCacheDir(), 10 * 1024 * 1024); // 10MB 缓存
OkHttpClient client = new OkHttpClient.Builder().cache(cache).build();
5. 其他特性

  • HTTP/2 支持：多路复用、头部压缩。

  • WebSocket：通过 okhttp-ws 模块支持长连接。

  • HTTPS：支持 TLS 1.3，可配置证书校验策略。

三、拦截器工作原理

OKHttp 的五大核心拦截器构成了其高效的网络请求处理链，每个拦截器职责明确，协同工作。以下是它们的详细工作流程和原理：

3.1 拦截器链的执行顺序

OKHttp 的请求处理基于责任链模式，五大核心拦截器按固定顺序依次处理请求和响应：请求从第一个拦截器进入，逐步传递到最后一个拦截器（CallServerInterceptor），响应则逆向返回。

3.2 五大拦截器的工作原理

1. RetryAndFollowUpInterceptor

核心职责：处理请求失败的重试与重定向。

  • 重试机制：
    若请求因网络问题（如连接超时、IO 异常）失败，根据配置决定是否重试（默认最多 20 次）。

  • 重定向处理：
    若服务器返回 3xx 状态码（如 302 临时跳转），自动构建新请求并重新发起。

  • 流程示例：

    Request → RetryAndFollowUpInterceptor → 发送请求 → 失败 → 判断是否重试 → 重新执行链  
Response ← 处理重定向 → 生成新 Request → 重新执行链

2. BridgeInterceptor

核心职责：桥接应用代码与网络请求，补充请求头、处理 Cookie 和响应编码。

  • 请求头补充：
    自动添加 User-Agent、Host、Content-Type 等头信息。
    若请求体为 RequestBody，自动计算 Content-Length。

  • Cookie 管理：
    通过 CookieJar 读取请求对应的 Cookie，写入 Cookie 头；保存响应中的 Set-Cookie。

  • 响应解码：
    若响应头包含 Content-Encoding: gzip，自动解压响应体。

3. CacheInterceptor

核心职责：根据缓存策略管理本地缓存，减少重复请求。

  • 缓存命中逻辑：

    1. 根据请求生成缓存 Key，检查本地是否有有效缓存。

    2. 若缓存未过期且有效（如 Cache-Control: max-age=3600），直接返回缓存响应，不再执行后续拦截器。

  • 缓存更新逻辑：

    1. 若缓存过期或需要验证（如 Cache-Control: no-cache），添加条件头（如 If-Modified-Since）发起请求。

    2. 若服务器返回 304 Not Modified，更新缓存元数据并返回缓存响应。

    3. 若服务器返回新数据，写入缓存。

4. ConnectInterceptor

核心职责：建立与服务器的 TCP/TLS 连接，复用连接池。

  • 连接复用机制：

    1. 根据请求的 URL、代理配置等生成连接标识（Address）。

    2. 从连接池（ConnectionPool）中查找可用连接，若存在则复用。

    3. 若无可用连接，创建新连接并加入连接池。

  • 连接释放：
    请求完成后，连接被标记为空闲，连接池根据策略（默认最大空闲连接数 5，存活时间 5 分钟）清理过期连接。

5. CallServerInterceptor

核心职责：执行实际的网络 I/O 操作，发送请求并读取响应。

  • 请求发送：

    1. 将请求头写入网络流。

    2. 若有请求体（如 POST 数据），分块写入流。

  • 响应接收：

    1. 读取响应头（如状态码、Content-Type）。

    2. 读取响应体，支持分块传输（Transfer-Encoding: chunked）。

  • 资源管理：
    确保请求和响应流正确关闭，异常时释放连接。

3.3 拦截器协作流程图
请求发起 → RetryAndFollowUpInterceptor（重试/重定向）  
           ↓  
           BridgeInterceptor（补全请求头）  
           ↓  
           CacheInterceptor（查询缓存）  
           ↓  
           ConnectInterceptor（建立连接）  
           ↓  
           CallServerInterceptor（发送请求）  

响应返回 ← CallServerInterceptor（读取响应）  
           ↑  
           ConnectInterceptor（释放连接）  
           ↑  
           CacheInterceptor（更新缓存）  
           ↑  
           BridgeInterceptor（解压响应）  
           ↑  
           RetryAndFollowUpInterceptor（处理最终结果）
3.4 关键场景分析

场景 1：缓存命中

  1. 请求到达 CacheInterceptor，发现有效缓存。

  2. 直接返回缓存响应，后续拦截器（如 ConnectInterceptor）不再执行。

  3. 节省网络开销，提升响应速度。

场景 2：重定向处理

  1. CallServerInterceptor 收到 302 响应。

  2. 响应返回到 RetryAndFollowUpInterceptor，生成新请求。

  3. 重新执行整个拦截器链，直到成功或超出重试次数。

3.5 总结

OKHttp 通过五大拦截器的分工协作，实现了高效、灵活的网络请求处理：

  • RetryAndFollowUpInterceptor：保障请求的可靠性。

  • BridgeInterceptor：简化开发，自动处理协议细节。

  • CacheInterceptor：优化性能，减少重复请求。

  • ConnectInterceptor：从连接池中复用已有连接，跳过 TCP/TLS 握手，降低延迟。。

  • CallServerInterceptor：完成最终的网络 I/O。

理解拦截器链的流程，有助于开发者定制拦截器（如日志打印、加密）或优化网络行为（如缓存策略、连接池配置）。

四、常见问题与优化

  1. 内存泄漏

    • 确保 Callback 或 Call 在 Activity/Fragment 销毁时取消：

      private Call call;
call = client.newCall(request);
call.enqueue(callback);

// 在 onDestroy() 中取消
if (call != null) call.cancel();

  2. 全局配置

    • 推荐将 OkHttpClient 实例化为单例，避免重复创建连接池。

  3. 自定义 DNS

    • 替换默认 DNS 以优化解析：

      client = new OkHttpClient.Builder()
    .dns(hostname -> {
        // 自定义 DNS 解析逻辑
        return InetAddress.getAllByName(hostname);
    })
    .build();

五、总结

OKHttp 的优势：

  • 高效：连接池、HTTP/2 支持、缓存机制。

  • 灵活：拦截器链可深度定制请求流程。

  • 易用：简洁的 API 设计，支持同步/异步调用。

适用场景：移动端 API 调用、文件下载/上传、需要精细控制网络行为的场景。

通过理解其原理，开发者能更好地优化网络层设计（如统一日志、请求加密、性能监控），并高效解决实际问题。

其它推荐：

《RxJava 深度解析：工作原理、核心操作符与高效实践指南》

《Binder机制原理分析· AIDL示例详解》

《Android View 的事件分发机制解析》

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：/a/984328.html

如若内容造成侵权/违法违规/事实不符，请联系我们进行投诉反馈qq邮箱809451989@qq.com，一经查实，立即删除！

相关文章

HeidiSQL：一款免费的数据库管理工具

HeidiSQL：一款免费的数据库管理工具

HeidiSQL 是一款免费的图形化数据库管理工具&#xff0c;支持 MySQL、MariaDB、Microsoft SQL、PostgreSQL、SQLite、Interbase 以及 Firebird&#xff0c;目前只能在 Windows 平台使用。 HeidiSQL 的核心功能包括&#xff1a; 免费且开源&#xff0c;所有功能都可以直接使用。…
阅读更多...
C/C++蓝桥杯算法真题打卡（Day3）

C/C++蓝桥杯算法真题打卡（Day3）

一、P8598 [蓝桥杯 2013 省 AB] 错误票据 - 洛谷 算法代码&#xff1a; #include<bits/stdc.h> using namespace std;int main() {int N;cin >> N; // 读取数据行数unordered_map<int, int> idCount; // 用于统计每个ID出现的次数vector<int> ids; …
阅读更多...
【2025软考高级架构师】——软件工程（2）

【2025软考高级架构师】——软件工程（2）

摘要 本文主要介绍了软件工程中常见的多种软件过程模型&#xff0c;包括瀑布模型、原型模型、V模型、W模型、迭代与增量模型、螺旋模型、构件组装模型、基于构件的软件工程&#xff08;CBSE&#xff09;、快速应用开发&#xff08;RAD&#xff09;、统一过程/统一开发方法和敏…
阅读更多...
【Vue3 Element UI - Plus + Tyscript 实现Tags标签输入及回显】

【Vue3 Element UI - Plus + Tyscript 实现Tags标签输入及回显】

Vue3 Element Plus TypeScript 实现 Tags 标签输入及回显 在开发后台管理系统或表单页面时&#xff0c;动态标签&#xff08;Tags&#xff09; 是一个常见的功能需求。用户可以通过输入框添加标签&#xff0c;并通过关闭按钮删除标签&#xff0c;同时还需要支持标签数据的提…
阅读更多...
Easysearch 使用 AWS S3 进行快照备份与还原：完整指南及常见错误排查

Easysearch 使用 AWS S3 进行快照备份与还原：完整指南及常见错误排查

Easysearch 可以使用 AWS S3 作为远程存储库&#xff0c;进行索引的快照&#xff08;Snapshot&#xff09;备份和恢复。同时&#xff0c;Easysearch 内置了 S3 插件&#xff0c;无需额外安装。以下是完整的配置和操作步骤。 1. 在 AWS S3 上创建存储桶 登录 AWS 控制台&#x…
阅读更多...
【CSS3】筑基篇

【CSS3】筑基篇

目录 复合选择器后代选择器子选择器并集选择器交集选择器伪类选择器 CSS 三大特性继承性层叠性优先级 背景属性背景色背景图背景图平铺方式背景图位置背景图缩放背景图固定背景复合属性 显示模式显示模式块级元素行内元素行内块元素 转换显示模式 结构伪类选择器结构伪类选择器…
阅读更多...
【MySQL】(4) 表的操作

【MySQL】(4) 表的操作

一、创建表 语法&#xff1a; 示例&#xff1a; 生成的数据目录下的文件&#xff1a; 二、查看表结构 三、修改表 语法&#xff1a; 另一种改表名语法&#xff1a;rename table old_name1 to new_name1, old_name2 to new_name2; 示例&#xff1a; 四、删除表 语法&#xf…
阅读更多...
C++：string容器（下篇）

C++：string容器（下篇）

1.string浅拷贝的问题 // 为了和标准库区分&#xff0c;此处使用String class String { public :/*String():_str(new char[1]){*_str \0;}*///String(const char* str "\0") // 错误示范//String(const char* str nullptr) // 错误示范String(const char* str …
阅读更多...
基于Harbor构建docker私有仓库

基于Harbor构建docker私有仓库

Harbor 是一个开源的企业级容器镜像仓库&#xff0c;主要用于存储、签名和扫描容器镜像。Harbor 基于 Docker Registry 构建&#xff0c;并在此基础上增加了许多企业级特性&#xff0c;以满足企业对安全性、可扩展性和易用性的需求。Harbor 的架构由多个组件组成&#xff0c;包…
阅读更多...
阿里发布新开源视频生成模型Wan-Video,支持文生图和图生图,最低6G就能跑,ComFyUI可用!

阿里发布新开源视频生成模型Wan-Video,支持文生图和图生图,最低6G就能跑,ComFyUI可用!

Wan-Video 模型介绍&#xff1a;包括 Wan-Video-1.3B-T2V 和 Wan-Video-14B-T2V 两个版本&#xff0c;分别支持文本到视频&#xff08;T2V&#xff09;和图像到视频&#xff08;I2V&#xff09;生成。14B 版本需要更高的 VRAM 配置。 Wan2.1 是一套全面开放的视频基础模型&…
阅读更多...
运动控制卡--概述学习

运动控制卡--概述学习

目录 概述 技术背景 常见的运动控制卡分类&#xff1a; 国外品牌 国内品牌 各个品牌官网 国外品牌 国内品牌 概述 运动控制卡被称作控制卡&#xff0c;只是因为它做成卡的形式&#xff0c;可以插进工控机主板上&#xff0c;一般走pci或pcie通讯。运动控制卡负责接收计算…
阅读更多...
网络编程-----服务器（多路复用IO 和 TCP并发模型）

网络编程-----服务器（多路复用IO 和 TCP并发模型）

一、单循环服务器模型 1. 核心特征 while(1){newfd accept();recv();close(newfd);}2. 典型应用场景 HTTP短连接服务&#xff08;早期Apache&#xff09;CGI快速处理简单测试服务器 3. 综合代码 #include <stdio.h> #include <sys/types.h> /* See NO…
阅读更多...
Java【网络原理】（3）网络编程续

Java【网络原理】（3）网络编程续

目录 1.前言 2.正文 2.1ServerSocket类 2.2Socket类 2.3Tcp回显服务器 2.3.1TcpEchoServer 2.3.2TcpEchoClient 3.小结 1.前言 哈喽大家好&#xff0c;今天继续进行计算机网络的初阶学习&#xff0c;今天学习的是tcp回显服务器的实现&#xff0c;正文开始 2.正文 在…
阅读更多...
SpringMvc与Struts2

SpringMvc与Struts2

一、Spring MVC 1.1 概述 Spring MVC 是 Spring 框架的一部分&#xff0c;是一个基于 MVC 设计模式的轻量级 Web 框架。它提供了灵活的配置和强大的扩展能力&#xff0c;适合构建复杂的 Web 应用程序。 1.2 特点 轻量级&#xff1a;与 Spring 框架无缝集成&#xff0c;依赖…
阅读更多...
web—HTML

web—HTML

什么是web ●Web:全球广域网&#xff0c;也称为万维网(www World Wide Web),能够通过浏览器访问的网站。 在浏览器中呈现精美的网页。 1.网页由那几部分组成&#xff1f; >文字、图片、视频、音频、超链接&#xff0c;&#xff0c;&#xff0c; 2.我们看到的网页&#xf…
阅读更多...
php虚拟站点提示No input file specified时的问题及权限处理方法

php虚拟站点提示No input file specified时的问题及权限处理方法

访问站点&#xff0c;提示如下 No input file specified. 可能是文件权限有问题&#xff0c;也可能是“.user.ini”文件路径没有配置对&#xff0c;最简单的办法就是直接将它删除掉&#xff0c;还有就是将它设置正确 #配置成自己服务器上正确的路径 open_basedir/mnt/qiy/te…
阅读更多...
INFINI Labs 产品更新 | Easysearch 增加异步搜索等新特性

INFINI Labs 产品更新 | Easysearch 增加异步搜索等新特性

INFINI Labs 产品更新发布&#xff01;此次更新&#xff0c;Easysearch 增加了新的功能和数据类型&#xff0c;包括 wildcard 数据类型、Point in time 搜索 API、异步搜索 API、数值和日期字段的 doc-values 搜索支持&#xff0c;Console 新增了日志查询功能。 INFINI Easyse…
阅读更多...
关于OceanBase与CDH适配的经验分享

关于OceanBase与CDH适配的经验分享

CDH是Cloudera早期推出的一个开源平台版本&#xff0c;它实质上成为了Apache Hadoop生态系统内公认的安装与管理平台&#xff0c;专为企业级需求量身打造。CDH为用户提供了即装即用的企业级解决方案。通过整合Hadoop与另外十多项关键开源项目&#xff0c;Cloudera构建了一个功能…
阅读更多...
解决VScode 连接不上问题

解决VScode 连接不上问题

问题 &#xff1a;VScode 连接不上 解决方案&#xff1a; 1、手动杀死VS Code服务器进程&#xff0c;然后重新尝试登录 打开xshell &#xff0c;远程连接服务器 &#xff0c;查看vscode的进程 &#xff0c;然后全部杀掉 [cxqiZwz9fjj2ssnshikw14avaZ ~]$ ps ajx | grep vsc…
阅读更多...
[Python爬虫系列]bilibili

[Python爬虫系列]bilibili

[Python爬虫系列]bilibili 具体逻辑 bv号 -> 处理多P视频 -> 拿到cid -> sign -> 请求下载&#xff0c;其中sign参考前人算法&#xff08;https://github.com/SocialSisterYi/bilibili-API-collect&#xff09; b站视频下载链接 https://api.bilibili.com/x/pl…
阅读更多...
最新文章

Copyright @ 2022~2023