Apollo iOS 分页库中 loadNext 方法的并发控制问题解析

问题背景

在 Apollo iOS 分页库的使用过程中，开发者发现当快速滚动列表时，loadNext 方法有时会错误地抛出 loadInProgress 错误，导致分页加载中断。这个问题主要出现在基于偏移量的前向分页列表中，当列表最后一项出现在屏幕上时触发加载更多数据的场景。

问题本质

问题的核心在于分页库内部的并发控制机制。当 loadNext 方法被调用时，库会检查 isFetching 标志位，如果为 true 则抛出错误。然而，在某些情况下，isFetching 标志位没有被及时重置，导致后续的 loadNext 调用被错误拒绝。

技术分析

1. 并发控制机制：

   • 分页库使用 isFetching 标志位来防止并发请求
   • 在 paginationFetch 方法中，通过 defer { isFetching = false } 确保标志位最终被重置
   • 问题出现在 defer 块没有及时执行，导致标志位保持 true 状态时间过长

2. Swift 并发模型：

   • 分页库内部使用了 Swift 的并发特性
   • AsyncGraphQLQueryPagerCoordinator 作为 actor 提供了基础的线程安全保证
   • 但 actor 的消息队列处理方式可能导致某些操作的执行顺序不符合预期

3. 缓存与网络请求的交互：

   • 当使用 returnCacheDataAndFetch 策略时
   • 应用会先收到缓存数据，然后发起网络请求
   • 这期间 isFetching 保持 true，可能导致后续 loadNext 调用被拒绝

解决方案探讨

1. 临时解决方案：

   • 在 watcher.refetch 完成后显式设置 isFetching = false
   • 这可以解决标志位未及时重置的问题

2. 设计考量：

   • 库作者选择不允许多个 loadNext 并发执行
   • 原因包括：避免重复请求、保证分页状态一致性
   • 也不采用请求队列，以避免掩盖逻辑错误

3. 推荐实践：

   • 使用 ScrollViewReader 监听滚动位置触发加载
   • 避免依赖 onAppear 触发加载，因其易受 SwiftUI 生命周期影响
   • 在 loadNext 回调中更新界面状态，而非在数据接收时

4. 状态管理改进：

   • 添加 hasFirstPageLoaded 标志区分初始加载状态
   • 在 fetch 回调中准确设置加载状态
   • 使用 showTailSpinner 明确控制尾部加载指示器

最佳实践建议

1. 分页触发策略：

   • 采用预加载策略，在距离列表底部一定距离时触发
   • 避免等到最后一项出现才加载，提升用户体验

2. 错误处理：

   • 对 loadInProgress 错误添加重试机制
   • 在开发环境使用 assertionFailure 捕获逻辑错误

3. SwiftUI 集成：

   • 合理使用 task 修饰符的生命周期
   • 考虑自定义滚动位置监听方案
   • 正确处理缓存和网络数据的显示逻辑

总结

Apollo iOS 分页库的并发控制机制设计考虑了数据一致性和错误预防，但在某些边界条件下可能导致分页中断。通过理解其设计原理和采用推荐的实践模式，开发者可以构建出更健壮的无限滚动列表功能。未来版本的库可能会提供更完善的回调机制和状态管理，进一步简化分页功能的实现。