iOS18下SwiftUI NavigationStack与searchable修饰符的根视图返回问题

问题复现场景 #

• RootView：展示1-7的列表项，点击进入ActivityView
• ActivityView：包含可搜索过滤的活动列表，使用searchable修饰符
• SettingView：提供调用popToRoot()返回根视图的按钮

在iOS18中，若先在ActivityView使用搜索栏过滤列表，再点击结果进入SettingView，此时点击返回根视图按钮会失效；未使用搜索过滤时功能正常，iOS17无此问题。

问题原因分析 #

iOS18对searchable与NavigationStack的交互逻辑做了调整：激活搜索栏时，系统会向导航栈中注入临时的搜索相关节点。此时调用popToRoot()时，会默认回到这个临时搜索节点，而非最初的RootView，导致返回根视图的逻辑失效。

解决方案 #

方案1：使用NavigationPath显式管理导航栈 #

通过绑定NavigationPath来完全控制导航栈的内容，不受系统临时注入节点的影响，是最可靠的解决方式。

代码示例：

// RootView
struct RootView: View {
    @State private var navigationPath = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $navigationPath) {
            List(1...7, id: \.self) { item in
                NavigationLink("Item \(item)", value: item)
            }
            .navigationDestination(for: Int.self) { _ in
                ActivityView(navigationPath: $navigationPath)
            }
            .navigationTitle("Root")
        }
    }
}

// ActivityView
struct ActivityView: View {
    @Binding var navigationPath: NavigationPath
    @State private var searchText = ""
    private let activities = ["跑步", "游泳", "骑行", "健身"]
    
    private var filteredActivities: [String] {
        searchText.isEmpty ? activities : activities.filter {
            $0.localizedCaseInsensitiveContains(searchText)
        }
    }
    
    var body: some View {
        List(filteredActivities, id: \.self) { activity in
            NavigationLink(activity, value: activity)
        }
        .navigationDestination(for: String.self) { _ in
            SettingView(navigationPath: $navigationPath)
        }
        .navigationTitle("活动列表")
        .searchable(text: $searchText)
    }
}

// SettingView
struct SettingView: View {
    @Binding var navigationPath: NavigationPath
    
    var body: some View {
        Button("返回根视图") {
            // 清空导航栈回到根视图
            navigationPath.removeAll()
        }
        .navigationTitle("设置")
    }
}

方案2：进入SettingView前关闭搜索状态 #

通过管理搜索栏的焦点状态，在进入SettingView前主动取消搜索激活，让导航栈恢复原本的层级结构，确保popToRoot()能正确指向RootView。

代码示例：

// ActivityView修改部分
struct ActivityView: View {
    @State private var searchText = ""
    @FocusState private var isSearchFocused: Bool // 管理搜索焦点
    private let activities = ["跑步", "游泳", "骑行", "健身"]
    
    private var filteredActivities: [String] {
        searchText.isEmpty ? activities : activities.filter {
            $0.localizedCaseInsensitiveContains(searchText)
        }
    }
    
    var body: some View {
        List(filteredActivities, id: \.self) { activity in
            NavigationLink(activity) {
                SettingView()
            }
            .onTapGesture {
                isSearchFocused = false // 关闭搜索焦点
            }
        }
        .navigationTitle("活动列表")
        .searchable(text: $searchText)
        .focused($isSearchFocused) // 绑定焦点状态
    }
}

// SettingView保持原逻辑
struct SettingView: View {
    @Environment(\.navigationStack) private var navigationStack
    
    var body: some View {
        Button("返回根视图") {
            navigationStack.popToRoot()
        }
        .navigationTitle("设置")
    }
}

总结 #

优先推荐方案1，显式管理导航栈是SwiftUI官方推荐的实践方式，能避免iOS版本更新带来的隐式行为差异，代码逻辑更清晰可控。方案2适合快速适配现有代码场景，但依赖对搜索状态的手动管理。

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