Apollo Client 缓存大小配置的深度解析

缓存机制的核心概念

Apollo Client 作为一款流行的 GraphQL 客户端，其内部缓存机制对性能有着至关重要的影响。其中 executeSelectionSize 参数控制着选择集执行结果的缓存大小，这个参数直接关系到应用的响应速度和内存使用效率。

缓存大小的默认值与实际配置

在 Apollo Client 3.11 版本中，存在一个文档与实际实现不一致的情况：代码注释声称 executeSelectionSize 的默认最大缓存大小为 10,000，但实际上源码中的默认值被设置为 50,000。这个差异源于开发者更新了默认值但未同步更新相关注释。

缓存工作原理详解

executeSelectionSize 控制的是 executeSelectionSet 方法调用结果的缓存容量。这个缓存采用最近最少使用(LRU)策略，保存最近 50,000 次不同参数调用 executeSelectionSet 的结果。

当查询结构如下时：

query AuthorsAndBooks {
  author {
    name
    books {
      name
      isbn
      comments {
        username
        content
      }
    }
  }
}

缓存使用情况会这样计算：

• 整个查询：1 次调用
• 每个作者对象：3 次调用（假设返回3位作者）
• 每本书：5 本书 × 3 位作者 = 15 次调用
• 每条评论：10 条评论 × 15 本书 = 150 次调用 总计需要约 169 个缓存条目来完整缓存这个查询结果

缓存溢出的影响与处理

当缓存达到容量上限时，系统会自动淘汰最久未被使用的缓存条目。这意味着：

1. 被淘汰的查询结果在下一次需要时需重新计算
2. 频繁的重新计算会导致性能下降
3. 可能引发连锁反应，导致更多缓存条目被淘汰

优化建议与最佳实践

1. 容量评估：访问应用中数据量最大的页面，测量此时的缓存使用量，然后乘以安全系数（建议2倍）
2. 内存考量：增大缓存会占用更多内存，但能减少重复计算
3. 平衡原则：缓存应足够大以容纳当前活跃页面的所有查询，但不必保留历史页面的查询结果
4. 监控调整：在实际运行中监控性能，根据实际情况调整缓存大小

技术实现细节

Apollo Client 的缓存系统采用分层设计：

• 顶层缓存查询结果
• 中层缓存规范化后的数据
• 底层缓存选择集执行结果

executeSelectionSet 缓存属于底层缓存，直接影响数据读取性能。适当增大这个缓存可以显著提升复杂查询的性能，特别是在数据关系复杂的应用中。

通过理解这些机制，开发者可以更合理地配置 Apollo Client 的缓存参数，在内存占用和性能之间取得最佳平衡。