Apollo iOS 中 GraphQLQueryWatcher 的崩溃问题分析与解决

问题背景

在 Apollo iOS 客户端库的使用过程中，开发者可能会遇到一个棘手的崩溃问题：当调用 GraphQLQueryWatcher 的 refetch() 或 cancel() 方法时，应用程序会触发 EXC_BAD_ACCESS 错误。这种崩溃通常发生在主线程上，且与内存访问相关。

崩溃表现

具体崩溃表现有两种形式：

1. 调用 refetch() 时的崩溃：崩溃发生在 GraphQLQueryWatcher.fetch() 方法的第一行代码处，即对 $fetching.mutate 的访问。

2. 调用 cancel() 时的崩溃：崩溃发生在 cancel() 方法的第一行代码处，即对 fetching.cancellable?.cancel() 的调用。

问题分析

经过深入调查，发现这类崩溃的根本原因是 重复链接 Apollo 库。具体表现为：

• 应用程序中同时存在两个 Apollo 库的实例
• 一个实例来自网络框架
• 另一个实例来自主应用程序

这种重复链接会导致内存管理混乱，特别是当涉及到 Swift 的并发机制和状态管理时。GraphQLQueryWatcher 内部使用了一些状态变量（如 fetching），当这些状态被两个不同的库实例操作时，就会导致内存访问异常。

解决方案

解决这个问题的关键在于确保 Apollo 库在整个应用程序中只被链接一次。具体措施包括：

1. 检查项目配置：确保 Apollo 库只在应用程序的一个层级中被链接，而不是在多个框架或模块中重复链接。

2. 统一依赖管理：如果使用 Swift Package Manager、CocoaPods 或 Carthage 等依赖管理工具，确保所有模块都引用同一个 Apollo 库版本。

3. 模块化设计：将网络相关功能集中在一个核心框架中，其他模块通过这个核心框架访问网络功能，避免各自引入网络库。

预防措施

为了避免类似问题，开发者可以采取以下预防措施：

1. 依赖树审查：定期检查项目的依赖树，确保没有重复的库链接。

2. 单例模式：对于网络客户端这类全局资源，考虑使用单例模式管理。

3. 内存调试：使用 Xcode 的内存调试工具检查异常的内存访问模式。

4. 单元测试：编写针对 GraphQLQueryWatcher 生命周期操作的单元测试，提前发现问题。

总结

Apollo iOS 客户端库中的 GraphQLQueryWatcher 崩溃问题通常与重复链接库有关。通过统一依赖管理和合理的项目架构设计，可以有效避免这类问题。开发者在使用这类高级功能时，应当特别注意内存管理和状态一致性，确保应用程序的稳定性。