iOS15下UITableView滚动触发prefetchedCells不同步报错如何解决

问题现象 #

• 使用自定义Cell的UITableView在iOS 14及更早版本运行无异常
• 升级iOS SDK 15后，滚动列表时触发报错，错误信息：

Assert UITableView internal inconsistency prefetchedCells and indexPathsForPrefetchedCells are out of sync

• 报错后伴随列表单元格随机消失的异常

根因说明 #

iOS 15 对UITableView的预取机制新增了内部一致性校验，当预取缓存的Cell和对应的索引路径状态不同步时就会触发该断言。常见触发场景包括：非主线程执行列表刷新、在CellForRow代理方法内触发列表更新、批量更新操作逻辑不规范、异步回调刷新了已经被复用的无效位置Cell。 #

可落地方案 #

快速修复方案（适配成本最低） #

直接关闭UITableView预取能力，从根源绕过预取状态校验：

// Objective-C
self.tableView.prefetchingEnabled = NO;

// Swift
self.tableView.isPrefetchingEnabled = false

说明：该方案会轻微降低超长列表的滚动加载性能，绝大多数常规业务场景下用户无感知

规范修复方案（不损失性能，推荐长期使用） #

• 所有UITableView的刷新、插入、删除、移动操作必须强制放在主线程执行，不要在子线程触发任何列表UI更新
• 禁止在tableView:cellForRowAtIndexPath:代理回调中执行任何列表刷新逻辑（包括reloadData、reloadRows、insertRows等操作）
• 批量更新列表时使用系统提供的批量更新接口，不要在更新动画过程中重复触发刷新操作：

tableView.performBatchUpdates({
    // 统一放置所有需要同步执行的row插入、删除、移动逻辑
}, completion: { _ in
    // 所有更新完成后的后续逻辑放在这里执行
})

• 自定义Cell内的异步资源（图片、网络数据）加载完成后，不要直接持有Cell实例做刷新，需要通过回调获取当前Cell对应的最新indexPath，判断indexPath仍处于可见范围内时再刷新对应条目，避免刷新已经被预取机制缓存复用的无效位置Cell。

新API适配方案（最低支持iOS15时可选） #

如果项目最低部署版本为iOS15+，优先使用UIListContentConfiguration配置Cell内容，减少直接操作Cell内部子视图带来的状态不一致问题。 #

内容的提问来源于stack exchange，提问作者kapill