OkHttp缓存实现问询：如何在联网时先读缓存再请求网络？

我明白你想要实现的是联网状态下先返回缓存数据，同时后台发起网络请求更新缓存的策略——这种模式能极大提升页面加载速度，给用户更流畅的体验。你的现有代码只处理了基础的缓存控制逻辑，还需要调整来实现这个双请求的流程，下面是完整的可行方案：

完整拦截器实现 #

import okhttp3.*;
import java.io.IOException;

public class CacheFirstInterceptor implements Interceptor {
    // 缓存有效期，单位秒，可根据业务需求调整
    private static final int CACHE_MAX_AGE = 3600;

    @Override
    public Response intercept(Chain chain) throws IOException {
        Request originalRequest = chain.request();
        boolean isConnected = CommonUtils.isNetConnected();

        if (isConnected) {
            // 第一步：先读取缓存并立即返回，让用户快速看到旧数据
            Request cacheRequest = originalRequest.newBuilder()
                    .cacheControl(CacheControl.FORCE_CACHE)
                    .build();
            Response cacheResponse = chain.proceed(cacheRequest);

            // 第二步：后台异步发起网络请求，更新缓存（不阻塞当前响应）
            Request networkRequest = originalRequest.newBuilder()
                    .cacheControl(CacheControl.FORCE_NETWORK)
                    .build();
            // 克隆请求做异步调用，避免阻塞当前线程
            chain.call().clone().enqueue(new Callback() {
                @Override
                public void onFailure(Call call, IOException e) {
                    // 网络请求失败，可在这里记录日志或做降级处理
                }

                @Override
                public void onResponse(Call call, Response response) throws IOException {
                    // OkHttp会自动将网络响应写入缓存，无需额外操作
                    response.close(); // 关闭响应，释放资源
                }
            });

            // 调整缓存头，保证后续请求的缓存逻辑正常
            return cacheResponse.newBuilder()
                    .removeHeader("Pragma")
                    .removeHeader("Cache-Control")
                    .header("Cache-Control", "public, max-age=" + CACHE_MAX_AGE)
                    .build();
        } else {
            // 无网络时，强制使用缓存，允许缓存过期最多30天（可调整）
            Request cacheOnlyRequest = originalRequest.newBuilder()
                    .cacheControl(CacheControl.FORCE_CACHE)
                    .build();
            Response cacheResponse = chain.proceed(cacheOnlyRequest);

            return cacheResponse.newBuilder()
                    .removeHeader("Pragma")
                    .removeHeader("Cache-Control")
                    .header("Cache-Control", "public, only-if-cached, max-stale=2592000")
                    .build();
        }
    }
}

关键逻辑说明 #

• 联网时的双请求设计：

  • 先构建强制读缓存的请求，拿到缓存响应后立刻返回给调用方，确保用户能快速看到内容；
  • 异步发起强制走网络的请求，后台完成后OkHttp会自动更新本地缓存，下次用户请求就能拿到最新数据；
  • 必须用异步调用，否则会阻塞当前返回缓存的流程，失去"快速响应"的意义。

• 无网络时的缓存兜底：

  • 使用CacheControl.FORCE_CACHE强制读取缓存，同时设置max-stale=2592000（30天），确保即使缓存过期也能返回数据，提升离线体验。

• 缓存头的处理：

  • 移除默认的Pragma和Cache-Control头，重新设置自定义规则，避免和服务器返回的缓存策略冲突。

使用注意事项 #

1. 确保你的OkHttpClient已经配置了本地缓存：

// 设置10MB的缓存目录
int cacheSize = 10 * 1024 * 1024;
Cache cache = new Cache(new File(context.getCacheDir(), "okhttp-cache"), cacheSize);

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

2. 服务器需要返回正确的缓存响应头（比如Cache-Control: public, max-age=3600），这样OkHttp才能正确缓存响应。如果服务器没有返回合适的头，你可以在拦截器中额外添加逻辑，强制标记响应为可缓存。

内容的提问来源于stack exchange，提问作者 "public"