Apollo Kotlin 中 HTTP 缓存共享机制解析

在 Apollo Kotlin 3.8.2 版本中，开发者可能会遇到 HTTP 缓存共享的问题。本文将深入分析这个问题，并提供解决方案。

问题背景

当多个 ApolloClient 实例共享同一个 HTTP 缓存目录时，即使设置了 NetworkOnly 缓存策略，查询结果仍会被写入缓存。这可能导致缓存文件访问冲突，特别是当不同客户端实例同时操作缓存文件时。

技术细节

Apollo Kotlin 的 HTTP 缓存机制基于 DiskLruCache 实现。在 3.8.2 版本中，即使设置了 NetworkOnly 策略，查询结果仍会被缓存，这是设计上的预期行为。

关键点在于：

1. DiskLruCache 内部实现了同步机制，确保单个实例的线程安全
2. 但当多个客户端实例使用相同缓存目录时，它们会创建各自的 DiskLruCache 实例
3. 这些实例之间没有协调机制，可能导致文件操作冲突

解决方案

方案一：共享 DiskLruHttpCache 实例

推荐的最佳实践是创建单个 DiskLruHttpCache 实例，并在多个 ApolloClient 之间共享：

// 创建共享缓存实例
val sharedCache = DiskLruHttpCache(
    FileSystem.SYSTEM, 
    File("缓存目录路径"),
    缓存大小
)

// 构建客户端时使用共享缓存
ApolloClient.Builder()
    .serverUrl("服务端URL")
    .httpCache(sharedCache)
    .build()

方案二：使用独立缓存目录

如果无法共享缓存实例，可以为每个客户端指定不同的子目录：

// 为不同客户端使用不同子目录
ApolloClient.Builder()
    .serverUrl("服务端URL1")
    .httpCache(File(cacheDir, "client1Cache"), 缓存大小)
    .build()

ApolloClient.Builder()
    .serverUrl("服务端URL2")
    .httpCache(File(cacheDir, "client2Cache"), 缓存大小)
    .build()

版本注意事项

在 3.8.2 版本中，确保使用正确的 httpCache 方法重载。如果使用文件路径方式初始化，每个客户端会创建自己的 DiskLruCache 实例，可能导致前述问题。

总结

在 Apollo Kotlin 中共享 HTTP 缓存时，应当注意：

1. 优先考虑共享 DiskLruHttpCache 实例而非目录
2. 如果必须使用独立实例，确保使用不同目录
3. 理解 NetworkOnly 策略不会阻止缓存写入，只是强制从网络获取

通过正确配置缓存共享机制，可以避免文件操作冲突，提高应用稳定性。