样板代码就不写了懒得码字，直接复制 chat-GPT 给的例子：

Retrofit 可以通过结合 OkHttp 来实现缓存功能。要为单个请求设置缓存，您需要创建一个新的 OkHttpClient 实例并将其传递给 Retrofit。然后，您可以使用 @Headers 注解在请求中指定缓存策略。

以下是一个使用 Retrofit 和 OkHttp 设置单个请求缓存的示例：

// 创建一个 OkHttpClient 实例并设置缓存
int cacheSize = 10 * 1024 * 1024; // 10 MiB
Cache cache = new Cache(context.getCacheDir(), cacheSize);

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

// 创建 Retrofit 实例并将 OkHttpClient 传递给它
Retrofit retrofit = new Retrofit.Builder()
    .baseUrl(BASE_URL)
    .client(okHttpClient)
    .build();

// 在请求中使用 @Headers 注解指定缓存策略
@Headers("Cache-Control: max-age=640000")
@GET("example")
Call<ResponseBody> getExample();

在这个例子中，我们创建了一个新的 OkHttpClient 实例并将其传递给 Retrofit。我们还使用 Cache 类来设置缓存大小和位置。在请求中，我们使用 @Headers 注解来指定缓存策略。max-age=640000 表示缓存将在 640000 秒（约 7.4 天）后过期。

.....................................................分割线..............................................................

聊一下自己想法及问题吧：

1.设置缓存路径，使用app内部缓存，可以越过文件访问权限

val cacheFile = File(UMApplication.application.cacheDir.path , "http_cache")
val cache = Cache(cacheFile, 1024 * 1024 * 1000) //缓存文件为100MB
OkHttpClient okHttpClient = new OkHttpClient.Builder()
    .cache(cache)
    .build();

2.该例子根本就无效果。

通过在api请求头添加@Headers("Cache-Control: max-age=640000")，只能设置到请求体上，经实验，似乎必须将该设置添加到Response的header上才有效。

引出networkInterceptor，将对Response进行拦截，然后设置header，才能真正实现缓存。

var networkInterceptor = Interceptor { chain ->
            val request = chain.request()
            val response: Response = chain.proceed(request)
            response.newBuilder()
                    .removeHeader("Pragma") //清除头信息，因为服务器如果不支持，会返回一些干扰信息，不清除下面无法生效
                    .header("Cache-Control", "public ,max-age=3600")
                    .build()
        }

..............

OkHttpClient okHttpClient = new OkHttpClient.Builder()
    .cache(cache)
    .addNetworkInterceptor(networkInterceptor)
    .build();

以上是全局请求设置缓存，如果需要做单个请求的缓存需求，只要稍微修改一下networkInterceptor

var networkInterceptor = Interceptor { chain ->
            val request = chain.request()
            // 读取请求体配置的缓存相关字段
            val maxAgeText = request.header("Cache-Control")
            val response: Response = chain.proceed(request)
            if(TextUtils.isEmpty(maxAgeText)){
                response.newBuilder().build()
            }else{
                response.newBuilder()
                    .removeHeader("Pragma") //清除头信息，因为服务器如果不支持，会返回一些干扰信息，不清除下面无法生效
                    .header("Cache-Control", "public ,$maxAgeText")
                    .build()
            }
        }

此处读取的 maxAgeText 就是在api添加的@Headers("Cache-Control: max-age=640000")，然后在有值的情况下进行 response header的设置。