使用SearchController后UITableView未标记单元格accessoryView异常显示为已标记求助

这个问题大概率是UITableView Cell复用逻辑和搜索状态下数据源一致性的问题，这是处理带搜索的列表时非常常见的坑，我帮你梳理几个关键排查点和解决办法：

1. 先检查Cell复用的状态重置逻辑 #

UITableView的Cell是复用池机制，当你搜索、清除搜索或取消搜索时，之前显示过的已标记Cell会被重新分配给新的用户。如果你的代码只在用户是待处理请求时设置标记的accessoryView，而没有在非待处理用户时明确重置accessoryView状态，就会出现旧状态残留的问题。

比如你可能写了类似这样的错误代码：

// 错误示例：只设置需要标记的情况，忽略不需要的
if pendingRequests.contains(user.uid) {
    cell.accessoryView = markedHeartButton
}

这种情况下，复用的Cell会保留之前的标记状态，导致非待处理用户也显示已标记。

正确做法：不管用户是否在待处理列表中，都明确设置accessoryView的状态：

let currentUser = isSearching ? filteredUsers[indexPath.row] : originalUsers[indexPath.row]
if pendingRequests.contains(currentUser.uid) {
    cell.accessoryView = markedHeartButton // 已标记的按钮
} else {
    cell.accessoryView = unmarkedHeartButton // 未标记的按钮，或者直接设为nil
}

另外，你可以在自定义Cell中重写prepareForReuse方法，强制重置状态，从根源避免复用残留：

class UserTableViewCell: UITableViewCell {
    override func prepareForReuse() {
        super.prepareForReuse()
        // 重置accessoryView为默认状态
        self.accessoryView = unmarkedHeartButton
        // 或者根据需求设为nil
        // self.accessoryView = nil
    }
}

2. 确认搜索状态下的数据源一致性 #

当使用SearchController时，你会维护一个原数据源（originalUsers）和一个过滤后的搜索数据源（filteredUsers）。需要确保：

• 过滤后的filteredUsers中的用户对象，和原数据源的用户是同一个实例，或者至少每个用户的UID能正确对应到pendingRequests集合中的数据。
• 当搜索文本变化、取消搜索时，你是否正确切换了数据源，并且调用了tableView.reloadData()来刷新列表？

比如，在updateSearchResults(for:)代理方法中，过滤用户时要保证用户的状态信息是完整的：

func updateSearchResults(for searchController: UISearchController) {
    guard let searchText = searchController.searchBar.text?.lowercased() else { return }
    filteredUsers = originalUsers.filter { user in
        user.name.lowercased().contains(searchText)
    }
    tableView.reloadData()
}

这里的filteredUsers直接复用原数据源的用户对象，这样判断pendingRequests.contains(user.uid)时结果才会准确。

3. 检查待处理请求集合的实时性 #

你的pendingRequests集合（存储当前用户待处理请求的UID）是否在Firebase数据更新时及时同步？比如当notifications节点有变化时，你需要重新拉取数据更新pendingRequests，并调用tableView.reloadData()刷新列表。

如果pendingRequests的数据是过时的，即使列表刷新，也会出现状态判断错误的情况。比如在Firebase的监听回调中：

func observePendingRequests() {
    let currentUserUID = Auth.auth().currentUser?.uid ?? ""
    db.collection("notifications").document(currentUserUID).addSnapshotListener { snapshot, error in
        guard let data = snapshot?.data() else { return }
        // 更新待处理请求集合
        self.pendingRequests = Set(data["pendingUIDs"] as? [String] ?? [])
        // 刷新列表，不管当前是否在搜索状态
        self.tableView.reloadData()
    }
}

4. 搜索状态切换时的数据源重置 #

当用户取消搜索或清除搜索文本时，你需要确保数据源切换回原列表，并且重新刷新：

// 在UISearchBarDelegate的回调中处理
func searchBarCancelButtonClicked(_ searchBar: UISearchBar) {
    isSearching = false
    tableView.reloadData()
}

func searchBar(_ searchBar: UISearchBar, textDidChange searchText: String) {
    if searchText.isEmpty {
        isSearching = false
        tableView.reloadData()
    } else {
        isSearching = true
        // 执行过滤逻辑并刷新
        updateSearchResults(for: searchController)
    }
}

这里的关键是isSearching标记要准确切换，确保cellForRowAt中使用正确的数据源。

总结一下，核心问题就是Cell复用导致的状态残留和搜索状态下数据源/状态集合的不一致，只要把这几点的逻辑补全，应该就能解决异常显示的问题。

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