Apollo iOS 中 JSONRequest 和 HTTPRequest 忽略缓存策略的问题解析

问题背景

在 Apollo iOS 客户端库的使用过程中，开发者发现即使将查询的缓存策略设置为 fetchIgnoringCacheCompletely，系统仍然返回了缓存数据。这显然与预期行为不符，因为该策略本应完全忽略缓存并从服务器获取最新数据。

问题根源

经过深入分析，发现问题出在 JSONRequest 和 HTTPRequest 的实现上。这两个组件在生成 URLRequest 时，没有正确处理传入的 cachePolicy 参数。具体表现为：

1. iOS 系统本身通过 URLCache 机制提供了请求缓存功能
2. 这个功能可以通过 URLRequest 的 cachePolicy 属性进行配置
3. Apollo iOS 在创建请求时，没有将自身的缓存策略(Apollo.CachePolicy)映射为对应的 URLRequest.CachePolicy

技术细节

Apollo iOS 提供了多种缓存策略选项：

• returnCacheDataElseFetch：优先返回缓存数据，如果没有则从服务器获取
• fetchIgnoringCacheData：忽略本地缓存数据，但仍可能将响应存入缓存
• fetchIgnoringCacheCompletely：完全忽略缓存，包括不存储新响应
• returnCacheDataDontFetch：只返回缓存数据，不从服务器获取
• returnCacheDataAndFetch：同时返回缓存数据并从服务器获取更新

然而，这些策略并没有正确转换为 iOS 系统级别的缓存控制机制。

解决方案

开发者提出了一个映射方案，将 Apollo 的缓存策略转换为 iOS 的 URLRequest.CachePolicy：

private var requestCachePolicy: URLRequest.CachePolicy {
    switch self.cachePolicy {
    case .returnCacheDataElseFetch:
        .returnCacheDataElseLoad
    case .fetchIgnoringCacheData:
        .reloadIgnoringLocalCacheData
    case .fetchIgnoringCacheCompletely:
        // URLRequest 没有完全避免存储响应的选项
        .reloadIgnoringLocalCacheData
    case .returnCacheDataDontFetch:
        .returnCacheDataDontLoad
    case .returnCacheDataAndFetch:
        // URLRequest 没有对应的行为
        .returnCacheDataElseLoad
    }
}

注意事项

1. GET 与 POST 的区别：使用 GET 方法时更容易出现缓存问题，因为 iOS 对 POST 请求的缓存行为与 GET 不同。Apollo 默认使用 POST 方法发送 GraphQL 请求。

2. 持久化查询：即使使用持久化查询(APQ)，GET 方法也不是默认选项。开发者需要明确配置才能使用 GET 方法。

3. 缓存控制：最佳实践是遵循服务器返回的 Cache-Control 头部指令，这能提供更精确的缓存行为控制。

结论

Apollo iOS 团队已经确认了这个问题，并在后续版本中进行了修复。开发者在使用缓存策略时应当注意：

• 明确了解不同策略的实际行为
• 根据需求选择合适的 HTTP 方法(GET/POST)
• 关注 Apollo iOS 的更新日志，了解缓存策略实现的改进

这个问题的解决确保了 Apollo iOS 的缓存行为更加符合开发者预期，特别是在需要强制从服务器获取最新数据的场景下。