混合使用两种NSDiffableDataSource快照导致UICollectionView重排时断言失败

AI 小北

2026-10-2

问题原因

你的使用方式完全符合Apple官方文档规范，该崩溃是UIKit内部实现的已知bug：当你混合使用NSDiffableDataSourceSnapshot全局快照和NSDiffableDataSourceSectionSnapshotsection快照时，系统会为每个单独调用过apply(_:to:)的section维护内部section快照实例，未单独应用过section快照的section没有对应实例，重排操作触发系统自动生成重排后快照的逻辑时，找不到对应索引触发断言失败。

可行规避方案

方案1：初始化时为所有section单独应用一次section快照，不要仅为部分section应用。即使section内数据和全局快照一致，统一为所有section执行section快照应用逻辑，保证系统内部为每个section生成对应实例，重排时不会触发索引查找失败。
代码示例：

// 应用完初始全局快照后，遍历所有section应用section快照
for section in Section.allCases {
    var sectionSnapshot = NSDiffableDataSourceSectionSnapshot<UUID>()
    sectionSnapshot.append(initialSnapshot.itemIdentifiers(inSection: section))
    dataSource.apply(sectionSnapshot, to: section, animatingDifferences: false)
}

方案2：自定义实现重排提交逻辑，跳过系统默认的快照生成流程。实现reorderingHandlers.didReorder闭包，手动处理重排变更、更新快照并应用，避免触发系统内部的bug逻辑。
代码示例：

dataSource.reorderingHandlers.didReorder = { [weak self] transaction in
    guard let self = self else { return }
    var currentSnapshot = self.dataSource.snapshot()
    currentSnapshot.apply(transaction.difference)
    self.dataSource.apply(currentSnapshot, animatingDifferences: false)
}