Apollo Client 4.0 中 partial 标志的优化调整

在 Apollo Client 4.0 版本中，开发团队对查询结果中的 partial 标志进行了重要调整，这一改动影响了数据获取和状态管理的核心逻辑。

原有问题分析

在之前的版本中，Apollo Client 存在一个不太合理的行为：只要查询结果不完整（根据 cache.diff 的返回值判断），就会自动设置 partial 标志。这种做法在以下两种情况下显得不够合理：

1. 当使用默认行为时（未显式设置 returnPartialData）
2. 当用户明确将 returnPartialData 设为 false 时

这种设计导致 partial 标志在某些场景下传达的信息不够准确，甚至可能引起误解。

解决方案

开发团队决定对这一问题进行修正，主要调整包括：

1. 条件性设置 partial 标志：现在只有当查询选项中明确设置了 returnPartialData 时，才会设置 partial 标志
2. 标志命名优化：考虑将 partial 重命名为 complete，以更清晰地表达其含义，避免歧义

技术细节

关于 partial 和 complete 的语义区别：

• partial 可能引起混淆：当缓存中完全没有查询所需数据时（data: undefined），是否应该被视为部分结果？
• complete 则更明确：只有当缓存能提供部分字段而非全部时，才标记为不完整

实际实现

最终实现方案略有调整：

1. 仍然会始终发出 partial 标志，但将其标记为已弃用
2. 暂未添加 complete 标志，计划在未来版本中通过其他方案解决（相关讨论见其他技术文档）

影响范围

这一变更属于破坏性更新（breaking change），主要影响：

1. 依赖 partial 标志进行条件渲染的应用程序
2. 需要精确判断数据完整性的特殊场景

最佳实践建议

对于现有应用程序：

1. 检查所有依赖 partial 标志的逻辑
2. 考虑迁移到更明确的完整性判断方式
3. 关注未来版本中关于数据完整性判断的进一步改进

这一优化使得 Apollo Client 的行为更加符合直觉，特别是在处理缓存数据和部分结果时，为开发者提供了更清晰的语义和更可靠的行为预期。