SwiftUI中NavigationLink+navigationDestination跳转异常问题求助

我是SwiftUI新手，正在尝试不同的NavigationStack用法。我实现了一个展示单词列表的导航栈，点击导航链接应进入对应单词的详情视图。但第一种实现方式点击链接后，详情视图仅闪一下就直接跳转到该视图的父视图，第二种方式却能正常运行。

问题代码（无法正常工作） #

var body: some View {     
        NavigationStack {
            List(dictionary, id: \.id) { wordDefinition in
                NavigationLink(wordDefinition.g_keyword, value: wordDefinition)
            }
            .navigationDestination(for: DictionaryEntry.self) { wordDefinition in
                DefinitionCardView(wordDefinition: wordDefinition)
            }
            .listStyle(PlainListStyle())
        }
    }

正常代码（可以正常运行） #

var body: some View {
        NavigationStack {
            List(dictionary, id: \.id) { wordDefinition in
                NavigationLink(wordDefinition.g_keyword, destination: DefinitionCardView(wordDefinition: wordDefinition))
            }
            .listStyle(PlainListStyle())
        }
    }

父视图代码（用于复现问题） #

var body: some View {
        NavigationStack {
            
            VStack(alignment: .leading) {
                
                SomeViewThatActuallyDoesNothing(searchWord: $searchWord)
                .onTapGesture {
                    isSearchFieldTapped = true;
                }
                
                NavigationLink {
                    DefinitionCardView(wordDefinition: wordOfTheDay)
                } label: {
                    SomeSampleCardView(wordOfTheDay: wordOfTheDay)
                }
                
            }
            .padding()
            .navigationDestination(isPresented: $isSearchFieldTapped) {
                MainSearchView() // 存在问题的视图（上述代码）
            }
            
        }  

最小复现代码 #

import SwiftUI
import SwiftData

struct ContView: View {
    
    var body: some View {
        
        NavigationStack {
            VStack(alignment: .center) {
                
                Spacer()
                
                NavigationLink {
                    MinNOTWorkingListView()
                } label: {
                    Text("A View With a Problem")
                }
                
                NavigationLink {
                    MinWorkingListView()
                } label: {
                    Text("A Working View")
                }
                
                Spacer()
                
                NavigationLink {
                    MinCardView(wordDef: "wordOfTheDay")
                } label: {
                    Text("Some Text")
                }
                
                Spacer()
            }
            .padding()
        }
    }
}



struct MinWorkingListView: View {
    
    private var wordList: [String] = {
        var list: [String] = []
        for i in 1...5 {
            list.append("Word" + String(i))
        }
        return list
    }()
    
    var body: some View {
        NavigationStack {
            List(wordList, id: \.self) { wordDefinition in
                NavigationLink(wordDefinition, destination: MinCardView(wordDef: wordDefinition))
            }
            .listStyle(PlainListStyle())
        }
    }
}

struct MinNOTWorkingListView: View {
    
    private var wordList: [String] = {
        var list: [String] = []
        for i in 1...5 {
            list.append("Word" + String(i))
        }
        return list
    }()
    
    var body: some View {
        NavigationStack {
            List(wordList, id: \.self) { wordDefinition in
                NavigationLink(wordDefinition, value: wordDefinition)
            }
            .navigationDestination(for: String.self) { wordDefinition in
                MinCardView(wordDef: wordDefinition)
            }
            .listStyle(PlainListStyle())
        }
    }
}

struct MinCardView: View {    
    var wordDef: String
    var body: some View {
            Text(wordDef)
    }
}

问题根源 #

核心矛盾在于嵌套NavigationStack与基于value的导航匹配逻辑冲突：

1. 父视图已存在顶层NavigationStack，子视图内部又创建新的NavigationStack，导致导航层级混乱。
2. 基于value的NavigationLink和navigationDestination是与当前最顶层的NavigationStack绑定的。子视图中定义的navigationDestination(for: String.self)属于内部嵌套的栈，但点击链接时，顶层栈会优先尝试匹配String类型的导航目标——而顶层栈没有对应目标，就会触发跳转后立刻回退的异常。
3. 使用destination参数的NavigationLink是直接指定目标视图，不依赖全局导航目标匹配，因此即使嵌套NavigationStack也能正常工作。

修复方案 #

• 移除子视图内部的NavigationStack，统一使用顶层NavigationStack管理所有导航。
• 将子视图的navigationDestination移到顶层NavigationStack的作用域内，或确保子视图的NavigationStack是当前唯一的导航容器。

修改后的MinNOTWorkingListView示例：

struct MinNOTWorkingListView: View {
    
    private var wordList: [String] = {
        var list: [String] = []
        for i in 1...5 {
            list.append("Word" + String(i))
        }
        return list
    }()
    
    var body: some View {
        // 移除内部的NavigationStack
        List(wordList, id: \.self) { wordDefinition in
            NavigationLink(wordDefinition, value: wordDefinition)
        }
        .navigationDestination(for: String.self) { wordDefinition in
            MinCardView(wordDef: wordDefinition)
        }
        .listStyle(PlainListStyle())
    }
}

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