Apollo Client 4.0 缓存查询策略优化解析

在 Apollo Client 4.0 版本中，针对 cache-only 查询策略与 returnPartialData 参数的交互逻辑存在一个关键行为修正。本文将从技术实现角度剖析该问题的本质、影响范围及解决方案。

问题背景

当开发者使用 cache-only 查询策略时，客户端会强制仅从本地缓存读取数据，不发起网络请求。此时若缓存数据不完整，系统会根据 returnPartialData 参数决定是否返回部分结果：

• true：允许返回不完整的缓存数据
• false（默认）：要求必须返回完整数据，否则返回 undefined

原逻辑缺陷

在 4.0 版本之前，即使设置 returnPartialData: false，当执行 cache-only 查询时，系统仍会错误地返回部分缓存数据。这与参数设计的初衷相违背，可能导致前端应用接收到非预期的残缺数据。

技术影响

该缺陷会产生以下连锁反应：

1. 数据一致性风险：UI 可能基于不完整数据渲染，导致显示异常
2. 逻辑判断失效：开发者依赖 undefined 判断缓存完整性的逻辑会失效
3. 性能损耗：需要额外编写防御性代码处理部分数据情况

解决方案

核心修复逻辑包含两个关键判断：

1. 当查询策略为 cache-only 时，严格遵循 returnPartialData 参数
2. 在 returnPartialData: false 模式下，若检测到缓存不完整：
   • 清除已读取的部分数据
   • 返回标准的 undefined 值

最佳实践建议

1. 关键数据查询建议显式设置 returnPartialData: false
2. 对于允许显示部分数据的场景，建议组合使用：

   {
     fetchPolicy: 'cache-first',
     returnPartialData: true
   }
   

3. 重要页面建议增加加载状态处理，同时应对 undefined 和部分数据两种情况

版本兼容性

该修复属于行为修正而非功能新增，不会破坏现有 API 契约。但开发者需要注意：

• 升级后原依赖部分数据渲染的组件可能需要调整
• 单元测试中针对缓存部分的断言可能需要更新

通过这次修正，Apollo Client 在缓存策略的严谨性上更进一步，帮助开发者更精确地控制数据获取行为，提升应用稳定性。