Retrofit与OkHttp缓存基础

本章聚焦 OkHttp 缓存模块的核心组件与运行机制，彻底理解 Cache、CacheStrategy 以及缓存目录/大小配置，才能在后续章节实现精确的动态缓存策略。

OkHttp 缓存架构概述

OkHttp 的缓存层位于应用层与网络层之间，由 CacheInterceptor 统一处理。一次请求进入后的执行顺序：

1. 应用发起请求 → OkHttpClient
2. 经过拦截器链，到达 CacheInterceptor
3. CacheInterceptor 利用 CacheStrategy 判断是否使用缓存
4. 若缓存命中且有效，直接返回缓存响应；否则请求网络
5. 网络响应返回后更新缓存

Cache 类与 CacheStrategy

缓存目录与大小配置

创建 Cache 对象需要指定磁盘目录和最大字节数。目录必须可写，否则 OkHttp 会静默降级（不缓存）。

// Java 示例
File cacheDir = new File(context.getCacheDir(), "http_cache");
int cacheSize = 10 * 1024 * 1024; // 10MB
Cache cache = new Cache(cacheDir, cacheSize);

OkHttpClient client = new OkHttpClient.Builder()
        .cache(cache)
        .build();

// Kotlin 示例
val cacheDir = File(context.cacheDir, "http_cache")
val cacheSize = 10L * 1024 * 1024
val cache = Cache(cacheDir, cacheSize)

val client = OkHttpClient.Builder()
    .cache(cache)
    .build()

缓存策略决策流程（SVG）

缓存配置参数对比