SwiftUI中使用.searchable移除搜索控制器引发警告问题求助

在iOS17 + SwiftUI导航栈（基于NavigationStack的path管理）的深栈应用中，使用.searchable实现列表过滤时，选中搜索结果后调用path.removeLast()会触发控制台警告/错误：

List failed to visit cell content, returning an empty cell. - SwiftUI/UICollectionViewListCoordinator.swift:367 - please file a bug report.（重复两次）
Someone is removing an active search controller while its search bar is visible. The UI probably looks terrible. Search controller being removed: <SwiftUI.SwiftUISearchController: 0x12c00d800> from navigation item: <UINavigationItem: 0x12d111fd0> style=navigator leftItemsSupplementBackButton

添加dismissSearch()会加重错误，仅用dismiss()会导致页面无响应，且必须通过修改path实现多视图弹出，无法依赖dismiss()。

方案1：先重置搜索状态，再延迟修改导航栈 #

核心思路是先清空搜索文本以重置搜索控制器状态，等待SwiftUI完成状态更新后再修改path，避免搜索控制器处于激活状态时导航栈变更：

假设你的搜索文本绑定为@State var searchText = ""，列表选中动作修改为：

.onTapGesture {
    // 1. 清空搜索文本，触发搜索控制器重置
    searchText = ""
    // 2. 等待下一个主循环周期再修改导航栈
    Task { @MainActor in
        try await Task.sleep(for: .milliseconds(100))
        dataService.path.removeLast()
    }
}

注：100ms的延迟是为了确保SwiftUI完成搜索状态的清理，可根据实际情况调整（最低可尝试50ms）。

方案2：利用@FocusState主动取消搜索栏焦点 #

通过@FocusState绑定搜索栏的焦点状态，先取消焦点再修改导航栈：

1. 添加焦点状态变量：

@FocusState private var isSearchFocused: Bool

2. 在.searchable中绑定焦点：

.searchable(text: $searchText, isPresented: $isSearchFocused)

3. 选中列表项时的动作：

.onTapGesture {
    // 1. 取消搜索栏焦点
    isSearchFocused = false
    // 2. 延迟修改导航栈
    Task { @MainActor in
        try await Task.sleep(for: .milliseconds(50))
        dataService.path.removeLast()
    }
}

这种方式比单纯清空文本更直接地控制搜索控制器的激活状态，能更可靠地避免状态冲突。

方案3：自定义导航栈状态更新逻辑 #

如果需要弹出多个视图（比如path.removeLast(n)），可以封装一个统一的方法，确保搜索状态先重置：

func popViews(count: Int) {
    // 先处理搜索状态
    searchText = ""
    isSearchFocused = false
    
    // 延迟执行导航栈修改
    Task { @MainActor in
        try await Task.sleep(for: .milliseconds(80))
        guard count <= dataService.path.count else { return }
        dataService.path.removeLast(count)
    }
}

调用时直接用popViews(count: 1)替代path.removeLast()即可。

这些方案本质是规避iOS17 SwiftUI中searchable与导航栈path更新的状态冲突问题，属于系统bug的临时 workaround。后续可关注iOS版本更新是否修复该问题。

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