SwiftUI中无法通过代码实现返回导航的问题排查与解决

问题场景 #

在iOS 16环境下，使用绑定了NavigationPath的NavigationStack时，点击详情页自定义返回按钮调用dismiss()，出现如下错误日志：

[Scene] Invalid attempt to call -[UIApplication requestSceneSessionDestruction:] from an unsupported device.

原实现代码：

struct ContentView: View {
    @State var navStack = NavigationPath()
    @Environment(\.dismiss) var dismiss
    
    var body: some View {
        NavigationStack(path: $navStack) {
            NavigationLink {
                Button {
                    dismiss()
                } label: {
                    Text("Pop Back")
                }
            } label: {
                Text("Detail View")
            }
        }
    }
}

错误原因 #

当NavigationStack通过path参数绑定了NavigationPath时，导航栈的状态完全由NavigationPath实例管理，此时@Environment(\.dismiss)的内部逻辑会和NavigationPath的控制逻辑冲突，导致调用了错误的系统方法，从而触发报错。

修复方案 #

方案一：通过操作NavigationPath实现返回 #

保留NavigationPath的绑定，直接修改路径数组来实现返回操作，替代dismiss()：

struct ContentView: View {
    @State var navStack = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $navStack) {
            NavigationLink {
                Button {
                    // 移除路径最后一个元素，实现返回上一页
                    navStack.removeLast()
                } label: {
                    Text("Pop Back")
                }
            } label: {
                Text("Detail View")
            }
        }
    }
}

方案二：移除NavigationPath绑定 #

如果不需要复杂的导航路径管理（比如多页面跳转、跨层级返回等），可以去掉NavigationStack的path参数，此时@Environment(\.dismiss)可以正常工作：

struct ContentView: View {
    @Environment(\.dismiss) var dismiss
    
    var body: some View {
        NavigationStack {
            NavigationLink {
                Button {
                    dismiss()
                } label: {
                    Text("Pop Back")
                }
            } label: {
                Text("Detail View")
            }
        }
    }
}

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