SwiftUI NavigationLink isActive绑定返回指定视图失效问题

问题复现代码 #

struct Root: View
{
    @Environment(\.dismiss) var dismissValue: DismissAction
    @State var rootToView1Navigattion: Bool = false
    
    var body: some View
    {
        HStack
        {
            NavigationLink(isActive: $rootToView1Navigattion) {
                View1()
            } label: {
                EmptyView()
            }

            Button {
                dismissValue()
            } label: {
                Text("Go Back")
                    .font(.title3)
                    .padding()
                    .background(Color.yellow)
            }

            Button {
                rootToView1Navigattion = true
            } label: {
                Text("Go Forward")
                    .font(.title3)
                    .padding()
                    .background(Color.green)
            }
        }
        .navigationTitle(String(describing: Self.self))
    }
}

struct View1: View
{
    @Environment(\.dismiss) var dismissValue: DismissAction
    @State var view1ToView2Navigation: Bool = false
    
    var body: some View
    {
        HStack
        {
            NavigationLink(isActive: $view1ToView2Navigation) {
                View2(view1ToView2NavBinding: $view1ToView2Navigation)
            } label: {
                EmptyView()
            }
            
            Button {
                dismissValue()
            } label: {
                Text("Go Back")
                    .font(.title3)
                    .padding()
                    .background(Color.yellow)
            }

            Button {
                view1ToView2Navigation = true
            } label: {
                Text("Go Forward")
                    .font(.title3)
                    .padding()
                    .background(Color.green)
            }
        }
        .navigationTitle(String(describing: Self.self))
    }
}

struct View2: View
{
    @Binding var view1ToView2NavBinding: Bool
    
    var body: some View
    {
        HStack
        {
            Button {
                view1ToView2NavBinding = false
            } label: {
                Text("Go Back")
                    .font(.title3)
                    .padding()
                    .background(Color.yellow)
            }
        }
        .navigationTitle(String(describing: Self.self))
    }
}

预期现象与实际问题 #

• 预期逻辑：View1中定义的view1ToView2Navigation状态同时绑定给NavigationLink的isActive参数、以Binding形式传递给View2，在View2中将该状态设为false时，应该自动pop回View1
• 实际现象：上述逻辑不生效
• 已知前提：RootView嵌套在NavigationView容器中，完全相同的实现逻辑在Root→View1的跳转中可以正常运行

问题原因 #

Root视图是NavigationView的根节点，持有的NavigationLink始终处于导航栈的活跃监听范围内，状态变更可以被导航控制器正确捕获。
而View1作为导航栈的中间层，和操作按钮同层级放置、以EmptyView为label的隐式NavigationLink会被SwiftUI视图渲染系统做层级优化，当View2被push入栈后，这个NavigationLink的状态监听链路会被暂时中断，View2中对绑定值的修改无法传递到导航栈核心，导致pop操作不触发。

修复方案 #

方案1：调整NavigationLink的放置位置 #

将隐式触发的NavigationLink从HStack的子视图移到视图的background/overlay修饰符中，避免被布局系统优化掉，修改View1代码如下：

struct View1: View
{
    @Environment(\.dismiss) var dismissValue: DismissAction
    @State var view1ToView2Navigation: Bool = false
    
    var body: some View
    {
        HStack
        {
            Button {
                dismissValue()
            } label: {
                Text("Go Back")
                    .font(.title3)
                    .padding()
                    .background(Color.yellow)
            }

            Button {
                view1ToView2Navigation = true
            } label: {
                Text("Go Forward")
                    .font(.title3)
                    .padding()
                    .background(Color.green)
            }
        }
        .navigationTitle(String(describing: Self.self))
        .background {
            NavigationLink(isActive: $view1ToView2Navigation) {
                View2(view1ToView2NavBinding: $view1ToView2Navigation)
            } label: {
                EmptyView()
            }
        }
    }
}

方案2：异步调度状态修改 #

如果不想调整视图层级，可以在View2修改绑定值时，将操作派发到主线程异步队列执行，避免状态变更和当前导航栈的转场逻辑冲突：

struct View2: View
{
    @Binding var view1ToView2NavBinding: Bool
    
    var body: some View
    {
        HStack
        {
            Button {
                DispatchQueue.main.async {
                    view1ToView2NavBinding = false
                }
            } label: {
                Text("Go Back")
                    .font(.title3)
                    .padding()
                    .background(Color.yellow)
            }
        }
        .navigationTitle(String(describing: Self.self))
    }
}

方案3（iOS 16+ 推荐）：使用新版导航栈API #

弃用存在大量状态同步问题的旧版NavigationView+isActive绑定方案，改用NavigationStack配合path状态统一管理导航栈，从根源上避免层级状态不同步问题。

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