Apollo iOS 中 SQLiteNormalizedCache 的缓存清理机制解析

问题背景

在使用 Apollo iOS 客户端进行 GraphQL 开发时，许多开发者会选择 SQLiteNormalizedCache 作为本地缓存方案。然而，近期有开发者反馈在调用 clearCache 方法后，虽然返回了成功状态，但 SQLite 数据库文件的大小并未发生变化，文件也没有被删除。

技术原理

SQLiteNormalizedCache 是 Apollo iOS 提供的一个基于 SQLite 数据库的规范化缓存实现。当调用 clearCache 方法时，实际上执行的是删除数据库表中的所有记录，但 SQLite 数据库文件本身并不会被自动删除或缩小。

这种现象源于 SQLite 的内部机制：

1. SQLite 采用预分配空间策略，删除记录后空间通常会被标记为可重用而非立即释放
2. 数据库文件作为持久化存储容器，设计上不会被自动删除

解决方案

Apollo iOS 提供了 shouldVacuumOnClear 参数来控制清理行为。当设置为 true 时，系统会在清除缓存后执行 SQLite 的 VACUUM 命令：

1. VACUUM 命令会重建整个数据库文件，释放未使用的空间
2. 这会导致数据库文件实际缩小到仅包含必要结构的大小
3. 但数据库文件本身仍然会保留，不会完全删除

最佳实践

对于需要彻底清理缓存的场景，建议：

1. 初始化 SQLiteNormalizedCache 时设置 shouldVacuumOnClear 为 true
2. 如果确实需要删除整个数据库文件，应该：
   • 先关闭所有数据库连接
   • 手动删除文件
   • 重新创建新的 SQLiteNormalizedCache 实例

注意事项

1. VACUUM 操作可能会对性能产生一定影响，特别是大型数据库
2. 频繁创建和删除数据库文件可能不是最佳实践，应考虑应用的实际需求
3. 在移动设备上，文件系统操作应该放在后台线程执行

通过理解这些机制，开发者可以更好地管理 Apollo iOS 客户端的缓存行为，确保应用性能和存储空间达到最佳平衡。