SwiftUI中Book类型NavigationLink与NavigationDestination匹配失效求助

问题场景代码 #

VStack {
    // other views

    List {
        Section("Recent Activity") {
            ForEach(viewModel.posts) { post in
                NavigationLink(value: post) {
                    PostListItemView(post: post)
                }
            }
        }
        
        Section("Reading List") {
            ForEach(viewModel.books) { book in
                NavigationLink(value: book) {
                    ReadingListItemView(
                        title: book.title,
                        authors: book.authors,
                        familiarity: book.familiarity
                    )
                }
            }
        }
    }
}
.navigationDestination(for: Book.self) { book in
    BookDetailsView(book: book, familiarity: .constant(book.familiarity))
}
.navigationDestination(for: Post.self) { post in
    PostDetailView(post: post)
}

Book和Post均遵循Hashable协议。点击ReadingListItemView时触发以下错误：

A NavigationLink is presenting a value of type “Book” but there is no matching navigationDestination declaration visible from the location of the link. The link cannot be activated.

Note: Links search for destinations in any surrounding NavigationStack, then within the same column of a NavigationSplitView.

点击同页面的PostListItemView可正常跳转，将navigationDestination移至对应List或Section内也无法解决问题。

疑似触发因素 #

• 当前视图的父视图本身是列表项，可能存在列表虚拟化导致的视图层级识别问题
• 根视图为包含三个标签页的TabView，每个标签页独立持有NavigationStack，且某相邻标签页中已存在针对Book.self的navigationDestination
• 若将所有标签页的NavigationStack替换为包裹整个TabView的单个栈，导航问题有所缓解，但会出现未触发跳转却自动推入视图的异常

问题原因分析 #

1. 跨Tab的类型冲突：SwiftUI的navigationDestination基于类型匹配，当多个分属不同Tab的NavigationStack中存在同类型（Book.self）的目的地声明时，导航系统会出现匹配歧义。当前Tab的NavigationLink可能被错误关联到其他Tab的目的地，或系统无法在当前栈中找到正确匹配项。

2. 列表虚拟化的层级问题：如果当前视图嵌套在父列表项中，SwiftUI的列表虚拟化机制可能导致视图树层级识别异常，使得navigationDestination的声明无法被当前栈内的NavigationLink正确感知。

3. 全局栈的副作用：用单个NavigationStack包裹整个TabView时，虽解决了跨Tab类型冲突，但所有Tab的导航动作共享同一个栈，容易出现状态串扰，导致未触发的跳转被意外执行。

解决方案建议 #

• 隔离Tab间的导航类型：确保每个Tab的NavigationStack内，同类型的navigationDestination唯一；或通过包装类型（如enum NavigationItem { case book(Book), case post(Post) }）区分不同Tab的导航目标，避免类型冲突。
• 修正视图层级：检查父列表项的嵌套结构，确保当前视图的navigationDestination声明直接绑定到其所属的NavigationStack层级内，避免嵌套过深导致的识别问题。
• 显式指定导航栈范围：使用NavigationStack的path绑定显式管理导航状态，确保NavigationLink和对应的navigationDestination处于同一个栈的状态管理范围内。

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