Apollo iOS 响应缓存机制优化：淘汰 legacyResponse 并支持增量缓存

背景与问题分析

在 Apollo iOS 客户端库中，缓存处理一直是性能优化的关键环节。原生的缓存写入拦截器(cacheWriteInterceptor)存在一个显著性能瓶颈：它需要对接收到的响应进行双重解析才能获取缓存记录。这种实现方式不仅效率低下，更重要的是无法兼容现代 GraphQL 查询中日益重要的部分响应(partial responses)和增量响应(incremental responses)特性。

技术实现痛点

双重解析机制的主要问题在于：

1. 首次解析用于常规的响应处理流程
2. 第二次解析专门用于提取缓存记录 这种重复工作不仅浪费计算资源，更重要的是在增量响应场景下，由于响应数据是分批次到达的，传统的双重解析机制根本无法正确捕获完整的缓存状态。

解决方案设计

Apollo iOS 团队提出的优化方案是重构响应处理流程：

1. 在首次响应解析时就捕获所有缓存记录
2. 将这些记录暂存起来供缓存写入拦截器后续使用
3. 完全移除对 legacyResponse 的依赖

这种改进带来三个主要优势：

1. 性能提升：消除冗余的解析操作
2. 功能扩展：为增量缓存提供基础支持
3. 代码简化：移除过时的 legacyResponse 处理逻辑

实现细节

在具体实现上，主要修改点包括：

1. 在响应解析器(response parser)中添加缓存记录收集功能
2. 设计新的数据结构暂存中间解析结果
3. 重构缓存写入拦截器使其直接使用预解析的记录
4. 确保整个流程对现有API保持兼容

影响与展望

这项改进不仅解决了当前性能问题，更重要的是为未来功能奠定了基础：

1. 为部分响应缓存铺平道路
2. 使增量查询结果缓存成为可能
3. 提升大型数据集查询时的内存效率

Apollo iOS 团队已通过相关PR完成了这项改进，标志着该客户端库在缓存处理方面迈入新阶段。对于开发者而言，这意味着更高效的缓存机制和更好的大规模数据查询体验，而所有这些改进都保持了对现有应用的向后兼容。