Swift实现UITableView滑动删除时报Index out of range错误如何解决

滑动删除触发Index out of range越界崩溃的核心原因是 UITableView当前渲染的行结构和绑定的数据源数组状态不一致，系统按照滑动位置生成的indexPath去访问数组时，对应索引位置不存在有效元素。

• 核对删除逻辑执行顺序：检查是否先调用了tableView.deleteRows(at:with:)触发UI刷新，之后才执行数组元素删除操作。UI刷新时会立刻回调tableView(_:numberOfRowsInSection:)获取当前行数，此时数组未更新，行数和UI预期的删除后状态不匹配直接触发越界。
• 检查数据源操作的线程：确认是否存在后台线程修改列表数据源数组的逻辑，UITableView的所有数据交互、UI刷新都必须在主线程执行，跨线程修改数组会导致count取值和实际元素数量不匹配。
• 排查刷新逻辑冲突：检查删除流程中是否在调用deleteRows的同时触发了tableView.reloadData()，两种刷新机制同时执行会导致indexPath错位。
• 核对索引有效性：检查是否使用了提前保存的旧indexPath取值——如果删除流程包含异步逻辑（比如接口请求、延迟操作），异步回调时原indexPath可能已经因为其他数据变动失效，直接用来访问数组就会越界。
• 检查多Section场景的索引逻辑：如果列表包含多个分区，是否错误地直接用indexPath.row访问一维数组，没有按分区拆分对应子数组。

标准单Section滑动删除实现 #

严格遵循 先改数据源，后刷新UI 的顺序，代码示例：

func tableView(_ tableView: UITableView, commit editingStyle: UITableViewCell.EditingStyle, forRowAt indexPath: IndexPath) {
    guard editingStyle == .delete else { return }
    // 第一步：优先删除数据源数组对应元素，必须放在UI刷新前
    dataList.remove(at: indexPath.row)
    // 第二步：执行单行UI删除动画，和数据改动严格对应
    tableView.deleteRows(at: [indexPath], with: .fade)
    // 注意：删除动画执行期间不要调用reloadData，避免刷新冲突
}

特殊场景适配 #

• 多分区列表：按分区维护对应子数据源，删除时先定位到对应分区的子数组再操作：

  // 假设sectionDataList是二维数组，每个元素对应一个分区的数据源
  sectionDataList[indexPath.section].remove(at: indexPath.row)
  tableView.deleteRows(at: [indexPath], with: .automatic)
  

• 异步删除场景：异步操作（比如网络请求确认删除）回调后，重新获取当前cell的最新indexPath，不要使用异步触发时缓存的旧索引：

  // 网络请求回调回到主线程后执行
  DispatchQueue.main.async {
      // 重新获取cell当前的有效indexPath
      guard let validIndexPath = tableView.indexPath(for: currentCell) else { return }
      dataList.remove(at: validIndexPath.row)
      tableView.deleteRows(at: [validIndexPath], with: .automatic)
  }
  

• 开启了Cell预取的列表：删除操作触发时取消所有待执行的预取任务，避免预取逻辑用旧索引访问更新后的数组。

内容的提问来源于stack exchange，提问作者Leonardo Rubio juarez