1、HTTP缓存基础与Retrofit拦截器概览

在深入 Retrofit 拦截器配置之前，必须先奠定 HTTP 缓存的理论基石。HTTP 缓存机制决定了客户端（App）能否复用先前请求的响应，从而避免重复发起网络请求。OkHttp 的拦截器体系正是操纵这些缓存行为的“插拔点”。

1.1 HTTP 缓存核心头

HTTP/1.1 定义了强制缓存和协商缓存两种策略。两者依赖的响应头不同，优先级也不同。

1.2 缓存策略分类与决策流程

OkHttp 内置的 CacheStrategy 类将上述头组合成三种最终决策：

• Network Only：仅从网络获取，不写缓存。适用实时数据。
• Cache Only：仅从本地缓存读取，不发起网络请求。适用离线模式。
• Cache + Network：优先读缓存，若过期则走协商缓存或强制请求。

1.3 Interceptor 在 OkHttp 中的地位

OkHttp 的拦截器分为两类，Application Interceptor（应用拦截器）与 Network Interceptor（网络拦截器）。缓存拦截器通常注册为应用拦截器，在请求发出前拦截并判断缓存策略；或在响应返回后更新缓存。

// 典型应用拦截器注册方式
OkHttpClient client = new OkHttpClient.Builder()
        .addInterceptor(new CacheInterceptor()) // 自定义缓存拦截器
        .cache(new Cache(context.getCacheDir(), 10 * 1024 * 1024)) // 10MB缓存目录
        .build();

1.4 课程最终交付物清单

通过本课程 30 章节的系统学习，您将获得以下可直接用于生产的交付物：

1.5 为什么从缓存拦截器开始

OkHttp 本身提供了 CacheInterceptor 实现，但其内置策略强制遵循 RFC 7234，无法满足以下常见需求：

• 离线优先：即使服务端返回 Cache-Control: no-store，仍希望本地缓存可用
• 自定义过期时间：根据业务代码动态设置 max-age，而非固定头
• 缓存预热：App 启动时从缓存中读取已知数据，避免白屏
• 流量节省：对图片等大资源强制使用协商缓存，降低带宽消耗

因此，掌握自定义缓存拦截器的原理和实现，是 Android 高级工程师流畅处理网络层的关键能力。