UITableView报错：尝试为同一索引路径出队多个单元格的问题咨询

错误成因 #

这个错误的核心问题出在你对UITableView生命周期方法的误用：

• 在tableView(_:cellForRowAt:)方法中，你已经为指定的indexPath完成了单元格的出队操作，这是UITableView加载单元格的标准流程，系统会基于这个方法返回的单元格来准备显示。
• 但在tableView(_:willDisplay:forRowAt:)方法里，你又尝试调用tableView.dequeueReusableCell(...)去获取同一个indexPath的单元格——这直接违反了UITableView的规则：同一个索引路径在单次单元格加载周期内只能被出队一次，系统因此抛出了这个错误。

而且从你的代码片段能看出来，willDisplay里的写法完全是错误的，这个方法的参数里已经直接提供了即将显示的cell实例，根本不需要再去手动出队。

解决方法 #

修改willDisplay方法，直接使用方法参数传入的cell即可，不需要再调用出队方法：

func tableView(_ tableView: UITableView, willDisplay cell: UITableViewCell, forRowAt indexPath: IndexPath) { 
    // 直接复用方法传入的cell，无需再次dequeue
    guard let customCell = cell as? CharacterCollectionDetailsTableCell else { 
        return // 这里不需要fatalError，因为cellForRowAt已经保证了单元格类型
    }
    // 在这里执行单元格即将显示时的操作，比如添加动画、更新状态等
}

额外补充：cellForRowAt是UITableView获取单元格的唯一入口，负责创建或复用单元格并返回给系统；而willDisplay是系统在单元格即将出现在屏幕上时的回调，此时单元格已经被正确初始化/复用完成，你只需要基于已有实例做后续处理即可。

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