SwiftUI：在onAppear中追加NavigationPath后出现异常行为

核心问题原因 #

你遇到的问题本质是SwiftUI视图生命周期与NavigationStack初始化时机不匹配：在onAppear中直接修改NavigationPath时，NavigationStack还未完成内部状态与NavigationPath的绑定，导致数据栈（控制台打印的长度）和UI栈（屏幕显示的计数）出现不一致，进而引发自定义返回按钮的崩溃。预览模式下视图初始化流程更同步，所以不会触发这个问题。

可行解决方案 #

方案1：延迟更新NavigationPath #

利用DispatchQueue.main.async让NavigationPath的修改推迟到当前视图渲染周期结束，确保NavigationStack完成初始化后再同步路由状态：

struct ContentView: View {
    @State private var path = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $path) {
            VStack {
                Text("screen count: \(path.count)")
                List(1...10, id: \.self) { num in
                    NavigationLink(value: num) {
                        Text("Push Screen \(num)")
                    }
                }
            }
            .navigationTitle("Home")
            .toolbar {
                ToolbarItem(placement: .navigationBarLeading) {
                    if !path.isEmpty {
                        Button("Back") {
                            path.removeLast()
                        }
                    }
                }
            }
            .navigationBarBackButtonHidden(true)
            .onAppear {
                // 延迟更新，等待NavigationStack初始化完成
                DispatchQueue.main.async {
                    path.append(1)
                    path.append(2)
                    path.append(3)
                    path.append(4)
                    print("path count: \(path.count)")
                }
            }
        }
    }
}

方案2：直接初始化NavigationPath（iOS 16+） #

如果是初始化时就需要设置路由栈，直接在NavigationPath的初始值中传入数据，跳过onAppear的时机冲突：

struct ContentView: View {
    // 直接初始化路由栈
    @State private var path = NavigationPath([1,2,3,4])
    
    var body: some View {
        NavigationStack(path: $path) {
            VStack {
                Text("screen count: \(path.count)")
                List(1...10, id: \.self) { num in
                    NavigationLink(value: num) {
                        Text("Push Screen \(num)")
                    }
                }
            }
            .navigationTitle("Home")
            .toolbar {
                ToolbarItem(placement: .navigationBarLeading) {
                    if !path.isEmpty {
                        Button("Back") {
                            path.removeLast()
                        }
                    }
                }
            }
            .navigationBarBackButtonHidden(true)
        }
    }
}

方案3：用ViewModel管理路由状态 #

将NavigationPath放到ViewModel中，利用ViewModel的初始化时机提前设置路由，彻底避开视图生命周期的冲突：

class RouterViewModel: ObservableObject {
    @Published var path = NavigationPath()
    
    init() {
        // 初始化时直接构建路由栈
        path.append(1)
        path.append(2)
        path.append(3)
        path.append(4)
    }
}

struct ContentView: View {
    @StateObject private var router = RouterViewModel()
    
    var body: some View {
        NavigationStack(path: $router.path) {
            VStack {
                Text("screen count: \(router.path.count)")
                List(1...10, id: \.self) { num in
                    NavigationLink(value: num) {
                        Text("Push Screen \(num)")
                    }
                }
            }
            .navigationTitle("Home")
            .toolbar {
                ToolbarItem(placement: .navigationBarLeading) {
                    if !router.path.isEmpty {
                        Button("Back") {
                            router.path.removeLast()
                        }
                    }
                }
            }
            .navigationBarBackButtonHidden(true)
        }
    }
}

额外注意点 #

• 自定义返回按钮时，必须先判断path.isEmpty，避免空栈时执行removeLast()导致崩溃
• 系统返回按钮能正常工作是因为它直接操作NavigationStack的内部UI栈，不依赖NavigationPath的状态，所以即使数据栈和UI栈不一致，它仍能跳转，但计数显示会异常

内容的提问来源于stack exchange，提问作者Arda Oğul Üçpınar