SwiftUI多层导航使用.navigationDestination的报错问题咨询

问题场景 #

开发SwiftUI应用时，主页面ContentView通过NavigationLink跳转到OtherView，OtherView的List中是绑定MyCustomType数据的NavigationLink项。当在OtherView的视图层级内添加.navigationDestination(for:destination:)时（即代码中的变体B），点击链接会打开视图副本并触发报错：

栈中已提前声明针对"MyCustomType"的navigationDestination，仅使用距离栈根最近的目标声明。

将OtherView设为NavigationStack根视图（变体A）可正常运行，但无法保留主页面的导航结构。希望尽可能避免路由枚举，但若有支持嵌套导航的枚举方案也可接受。

原因分析 #

SwiftUI的NavigationStack中，.navigationDestination是基于整个导航栈的类型匹配规则工作的。当在嵌套视图（如NavigationLink的目标视图）中声明同一数据类型的navigationDestination时，会与导航栈中已存在的同类型声明产生冲突——SwiftUI只会使用距离栈根最近的那个声明，导致跳转逻辑异常并抛出错误。

解决方案 #

方案1：将navigationDestination提升到导航栈根层级 #

把针对MyCustomType的navigationDestination声明移到NavigationStack的根视图（ContentView）中，整个导航栈内只保留一份同类型的跳转声明，避免冲突。

修改后的代码：

// ContentView.swift
struct ContentView: View {
    var body: some View {
        NavigationStack {
            NavigationLink("Some Link") {
                OtherView()
            }
            // 将跳转声明放在导航栈根层级
            .navigationDestination(for: MyCustomType.self) { item in
                Text(item.description)
            }
        }
    }
}

// OtherView.swift（无需修改）
struct OtherView: View {
    let dummyItems: [MyCustomType] = [
        .init(/* something 1 */),
        .init(/* something 2 */),
        .init(/* something 3 */)
    ]
    
    var body: some View {
        List {
            ForEach(dummyItems, id: \.id) { item in
                NavigationLink(value: item) {
                    Text(item.description)
                }
            }
        }
    }
}

方案2：使用枚举统一管理路由（支持嵌套导航） #

通过枚举封装所有导航路由类型，用单一的navigationDestination处理枚举类型的跳转，从根源避免同数据类型的重复声明问题，同时适配复杂的多层嵌套导航场景。

步骤1：定义路由枚举

enum AppRoute: Hashable {
    case otherView
    case customItem(MyCustomType)
}

步骤2：修改主视图的导航逻辑

// ContentView.swift
struct ContentView: View {
    var body: some View {
        NavigationStack {
            NavigationLink(value: AppRoute.otherView) {
                Text("Some Link")
            }
            // 统一处理所有路由枚举的跳转
            .navigationDestination(for: AppRoute.self) { route in
                switch route {
                case .otherView:
                    OtherView()
                case .customItem(let item):
                    Text(item.description)
                }
            }
        }
    }
}

步骤3：修改OtherView的跳转链接

// OtherView.swift
struct OtherView: View {
    let dummyItems: [MyCustomType] = [
        .init(/* something 1 */),
        .init(/* something 2 */),
        .init(/* something 3 */)
    ]
    
    var body: some View {
        List {
            ForEach(dummyItems, id: \.id) { item in
                // 跳转值改为对应的路由枚举case
                NavigationLink(value: AppRoute.customItem(item)) {
                    Text(item.description)
                }
            }
        }
    }
}

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