（三）OkHttp网络请求拦截器详解

最新推荐文章于 2025-06-19 21:44:38 发布

原创最新推荐文章于 2025-06-19 21:44:38 发布 · 3.3k 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#okhttp

zh和他的Android 专栏收录该内容

37 篇文章

订阅专栏

本文详细解读了OkHttp的五大拦截器（重试与重定向、桥接、缓存、连接和请求服务）如何通过责任链模式协作完成网络请求，包括拦截器的工作原理和自定义拦截器的应用。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前面章节讲解了OkHttp的模型架构和网络请求各个参数的意义。本章节主要讲解OkHttp真正进行网络请求的部分，也就是拦截器。

OkHttp默认实现的有，重试与重定向拦截器、桥接拦截器、缓存拦截器、连接拦截器和请求服务拦截器。他们用责任链设计模式有效的组合成一个整体，完成复杂的网络请求工作。

一、责任链设计模式

责任链模式是常见的23种设计模式其中之一。在责任链模式里，多个对象由每一个对象对其下家的引用而连接起来形成一个链条。请求在这个链上传递，链上的每个节点都可以对请求进行处理。这种设计模式可以方便的在链条上增加和删除处理节点，使得系统可以在不影响客户端的情况下动态地重新组织和分配责任。

二、五大拦截器

前面在讲OkHttp网络请求框架时，“getResponseWithInterceptorChain”这个方法，最后会返回请求的结果。这个方法首先将各个拦截器串在责任链上，然后开启责任链网络请求的工作在各拦截器进行流转。

接下来我们详细看一下这几个拦截器的内部是如何工作。

2.1重试与重定向拦截器 RetryAndFollowUpInterceptor

这个拦截器，首先前置工作做链接准备，寻找一条可用的链接。

然后开始中置工作，开启后面的拦截器，进行处理。

最后开启后置工作，根据中置工作后面拦截器的返回结果判断是否进行重试、重定向或者直接将结果返回。

重试

通过某条连接线路失败，需要重试。执行continue重新开始一轮请求。

此时如果!recover则抛出异常，不在进行重试。recover中判断的情形主要有：设置了禁止重试开关、该请求体不能二次发起、返回的异常不能发起重试、连接已不可达。

重定向

请求返回结果没有连接异常，检查服务器返回结果是否发生服务器地址迁移，需要进行重定向。前面网络相关知识介绍过重定向的返回有301和302分别表示资源永久迁移和临时迁移。

这里就是根据返回的标记，以及返回重定向后网址。进行发起重定向。

followUpRequest()这个方法，就是从响应中提取重定向相关信息。

如果有发生资源重定向，并且重定向次数没有超过限制--20次，则修改请求内容，重新开始新一轮请求。

2.2桥接拦截器 BridgeInterceptor

这个拦截器主要是Okhttp帮助我们生成HTTP请求头的内容。下面分别具体看一下：

设置内容类型、内容长度和分块传输。OkHttp根据我们传入参数解析内容类型、自动计算内容的长度，如果是分块传输则设置分块传输指令并填入当前块长度。

设置主机名。根据传入的url自动解析出主机名，并自动填入请求头。

设置长连接。

设置gzip压缩。为了减少数据传输的体积，okHttp会默认帮我们设置“使用gZip”压缩。在该拦截器的后置阶段会自动帮我们解gZip压缩。

自动带入cookie，如果有的话。

设置代理

完成上面请求头设置后，进入中置阶段，交给下一个拦截器进行处理。

后置阶段，拿到后面拦截器返回的结果，对结果进行gZip解压，再交给前一个拦截器。

桥接拦截器，就是帮我们做在HTTP请求时，需要我们做，但是做起来会很麻烦的事----生成请求头。从而大大的减轻我们的工作量。

2.3缓存拦截器 CacheInterceptor

进行Get请求时，在真正向服务器发起请求之前，先判断是否命中缓存。缓存如果命中，则直接使用缓存的内容，不用再向服务器发起请求。从而减小网络访问的开销。

这个拦截器执行的步骤是：

1、从缓存中获取请求对应的缓存数据；

2、创建缓存策略CacheStrategy，根据策略类的成员变量networkRequest和cacheResponse判断使用缓存的方式。它们的组合如下：

networkRequest	cacheResponse	策略
Null	NotNull	直接使用缓存
NotNull	Null	不使用缓存，向服务器发起请求
Null	Null	直接返回504（Gateway Timeout）
NotNull	NotNull	发起请求，得到响应为304则使用缓存

3、若需要向服务器发起请求，则流转到下一个拦截器进行处理；

4、返回304表示服务器无修改，可以使用缓存。否则，使用网络响应的内容，并缓存本次响应数据。

2.4连接拦截器 ConnectInterceptor

这个拦截器，是建立一个连接用来发起请求。和前面拦截器不同，建立拦截之后，直接交给下一个拦截器进行处理，它没有后置处理的工作。

这里有一个很重要的过程，就是对连接的复用。当没有可以复用的连接时，才会创建连接。

获取连接的调用流程：ConnectInterceptor:intercept() -> RealCall:initExchange()->ExchangeFinder:find()->findHealthyConnection()->findConnection()

返回的codec就是编码解码器，根据HTTP不同版本返回不同的编码规则。

findConnection方法就是做的获取连接的工作。主看看一下这个方法：

第1、从连接池中查找。遍历连接池，判断每一个连接看是否有可用的。

这里判断的可用的方法，首先看是否支持多路服用，即是HTTP2协议。

在isEligible方法中判断是否可以复用：

判断是否连接超过限制，HTTP1.X一个连接只能处理一个请求，noNewExchanges表示不可以处理新的请求。

判断当前连接和目标请求是否指向相同，地址、端口、代理等都要一样

判断主机名是否一致。

下面这些是针对HTTP2的对于连接是否可以合并的判断。

以上都没有问题，则isEligible方法返回true，表示可以连接可以复用。进一步返回连接。如果此时无法获取则findConnection方法继续向下进行。

第2、判断是否可以多路复用。带入routes参数，再一次遍历连接池。

上一次只能得到HTTP1.X的复用连接，这里才能获得HTTP2的连接复用。

routes是通过RouteSelector获取的。只有routes不为空时，才会走到这里进行连接复用获取。

Route表示“路由”，它是由代理、ip地址和端口组成。代理有三种类型：DIRECT(没有代理，直连方式)、HTTP、SOCKS。一个域名可能有多个ip地址。到达一个域名有多种连接方式，经过相同类型代理到达指定域名的会被分到一个routerSelection，多个routerSection并入到RouteSelector中。RouteSelector中存储的是所有到达目标域名的路由。

举个例子，

域名 mydemo.com，有1.2.3.4:443 和5.6.7.8:443 两个地址。

现在有三个HTTP代理，分别是9.10.11.12，13.14.15.16，17.18.19.20

则到达该域名路由有8种，两种直连方式，6种代理方式。这些都会记录在RouteSelector中。