SwiftUI NavigationPath路由异常：原生导航与自定义路由不同步

核心问题出在你没有将NavigationStack与Router的path做双向绑定，同时混合使用了旧的NavigationLink写法，导致原生导航操作（返回按钮、Link跳转）无法同步更新你的path状态。

关键修复步骤 #

1. 绑定NavigationStack到Router的path

必须使用带path参数的NavigationStack初始化方法，让SwiftUI自动同步导航栈和你的path变量：

NavigationStack(path: $router.path) {
    // 你的视图内容
}

这样不管是原生返回按钮、侧滑返回，还是用value-based的NavigationLink跳转，都会自动修改router的path，保持状态一致。

2. 确保导航目标枚举遵循Hashable

NavigationPath的元素必须是Hashable类型，所以你的枚举需要显式添加协议（如果FormNavigationItem没继承Hashable的话）：

class ProfileRouter: BaseRouter {
    enum ProfileViewDestination: Hashable {
        case viewA
        case viewB
    }
    
    enum ViewADestination: FormNavigationItem, Hashable {
        case viewC
    }

    // 保留原有的自定义导航方法
    func navigate(to destination: ProfileViewDestination) {
        path.append(destination)
    }
    
    func navigate(to destination: ViewADestination) {
        path.append(destination)
    }
}

3. 使用Value-Based的NavigationLink

放弃旧的NavigationLink(destination:)写法，改用NavigationLink(value:)配合navigationDestination注册视图，这样跳转时会自动将目标添加到绑定的path中：

struct ProfileView: View {
    let router = ProfileRouter()
    
    var body: some View {
        NavigationStack(path: $router.path) {
            VStack {
                // 代码触发导航（保留原有逻辑）
                Button("跳转到View A") {
                    router.navigate(to: .viewA)
                }
                
                // 原生NavigationLink跳转（自动同步path）
                NavigationLink(value: ProfileRouter.ProfileViewDestination.viewB) {
                    Text("跳转到View B")
                }
            }
            // 注册ProfileViewDestination对应的视图
            .navigationDestination(for: ProfileRouter.ProfileViewDestination.self) { destination in
                switch destination {
                case .viewA:
                    ViewA(router: router)
                case .viewB:
                    ViewB()
                }
            }
            // 注册ViewADestination对应的视图
            .navigationDestination(for: ProfileRouter.ViewADestination.self) { destination in
                if case .viewC = destination {
                    ViewC()
                }
            }
        }
    }
}

4. 验证同步效果

• 点击自定义Button调用navigate(to:)：path更新，NavigationStack自动导航；
• 点击NavigationLink：SwiftUI自动将目标添加到path，状态同步；
• 点击原生返回按钮/侧滑返回：path自动移除最后一个元素，状态一致；
• 调用navigateBack()或popToRoot()：path修改后，NavigationStack自动更新导航栈。

为什么之前会出问题？ #

• 未绑定path时，原生导航操作直接修改SwiftUI内部的导航栈状态，不会同步到你的router.path；
• 旧的NavigationLink(destination:)不依赖path，直接添加视图到导航栈，导致path中没有对应的条目，调用navigateBack()时会多返回一级。

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