UICollectionView取消拖拽会话后单元格原地重复问题咨询

我之前也碰到过类似的UICollectionView拖拽异常，结合你给出的重现步骤，大概率是拖拽会话取消时，数据源或集合视图的状态没有正确重置导致的，咱们一步步拆解问题并给出解决方案：

可能的原因及排查方向 #

1. 拖拽取消时数据源状态未重置 #

当你选中多个项目启动拖拽时，可能会在collectionView(_:itemsForBeginning:at:)或相关拖拽代理方法里标记这些项目的状态（比如临时从数据源移除、标记为「拖拽中」），但取消拖拽时没把这些状态完全恢复。等到再次拖拽时，旧的标记残留，导致数据源出现重复项，最终单元格重复显示。

排查&修复：
一定要在拖拽会话结束的代理方法里处理取消场景的状态重置：

func collectionView(_ collectionView: UICollectionView, dragSessionDidEnd session: UIDragSession) {
    if session.isCancelled {
        // 1. 重置所有标记为拖拽中的项目状态
        for item in yourDraggingItemCache {
            item.isBeingDragged = false
        }
        // 2. 清空拖拽缓存
        yourDraggingItemCache.removeAll()
        // 3. 刷新涉及的单元格，确保视图和数据源同步
        let affectedIndexPaths = yourDraggingItemCache.map { /* 转换为对应的indexPath */ }
        collectionView.reloadItems(at: affectedIndexPaths)
    }
}

2. 集合视图的状态未正确刷新 #

取消拖拽后，UICollectionView可能残留了旧的选中状态、临时占位视图或快照，导致再次拖拽时和真实单元格重叠显示。

排查&修复：
在拖拽会话结束（无论成功还是取消）后，强制刷新涉及的单元格，而不是依赖系统自动更新：

// 拖拽会话结束通用处理
func handleDragSessionCompletion(isCancelled: Bool, affectedIndexPaths: [IndexPath]) {
    if isCancelled {
        // 重置数据源状态（参考上面的代码）
    }
    // 刷新单元格，清除残留状态
    collectionView.reloadItems(at: affectedIndexPaths)
    // 额外重置选中状态（如果需要）
    collectionView.deselectAllItems(animated: false)
}

3. 文件夹拖入逻辑存在漏洞 #

第二次拖拽项目到文件夹时，可能误将上次取消拖拽的旧选中集合也包含进去，导致项目被重复添加到文件夹，同时原位置单元格因为数据源没更新依然存在，形成重复。

排查&修复：
在处理拖入逻辑时，一定要基于当前拖拽会话的items获取有效项目，不要依赖本地缓存的选中状态：

func collectionView(_ collectionView: UICollectionView, performDropWith coordinator: UICollectionViewDropCoordinator) {
    guard let destIndexPath = coordinator.destinationIndexPath,
          let targetFolder = yourDataSource.item(at: destIndexPath) as? Folder else {
        return
    }
    
    // 只处理当前拖拽会话中的项目
    for dropItem in coordinator.items {
        guard let draggedItem = dropItem.dragItem.localObject as? YourItemModel,
              !targetFolder.items.contains(draggedItem) else {
            continue
        }
        // 添加到文件夹
        targetFolder.items.append(draggedItem)
        // 从原数据源移除
        yourDataSource.removeItem(draggedItem)
    }
    
    // 刷新文件夹和原位置的单元格
    let reloadPaths = [destIndexPath] + coordinator.items.compactMap { $0.sourceIndexPath }
    collectionView.reloadItems(at: reloadPaths)
}

核心总结 #

解决这类问题的关键是：确保每一次拖拽会话（无论成功还是取消）结束后，数据源和集合视图的状态都完全重置，不留下任何残留数据或标记。这样后续的拖拽操作才会基于正确的状态执行，避免出现单元格重复这类异常。

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