SwiftUI中NavigationStack半滑返回后导航失效问题求助

问题现象 #

使用SwiftUI的NavigationStack时，执行半滑返回操作后取消，后续通过NavigationLink(isActive:)绑定的导航功能会失效，点击按钮无法正常跳转到目标视图。

可复现代码 #

import SwiftUI

struct ContentView: View {
    var body: some View {
        NavigationStack {
            ListView()
        }
    }
}

struct ListView: View {
    var body: some View {
        List {
            NavigationLink(destination: ViewA(viewModel: .init()), label: {
                Text("A")
            })
                
            NavigationLink(destination: ViewB(), label: {
                Text("B")
            })
        }
    }
}

struct ViewA: View {
    @StateObject var viewModel: Observed
    
    var body: some View {
        ZStack {
            List {
                Button(action: {
                    viewModel.action()
                }, label: {
                    Text("label")
                })
            }
            
            NavigationLink(isActive: $viewModel.shouldShowViewB, destination: {
                ViewB()
            }, label: {EmptyView()})
        }
        .navigationTitle("view a")
    }
}

struct ViewB: View {
    var body: some View {
        List {
            Button(action: {
                print("actionb")
            }, label: {
                Text("labelb")
            })
        }
        .navigationTitle("view b")
    }
}

class Observed: ObservableObject {
    @Published var shouldShowViewB = false
    
    func action() {
        print("action from model")
        shouldShowViewB = true
    }
}

解决方案 #

该问题是NavigationStack与isActive绑定的状态同步bug导致的，以下是两种可靠修复方式：

方式一：使用NavigationPath管理导航（推荐） #

这是SwiftUI 4+官方推荐的导航管理方案，通过绑定NavigationPath可彻底避免isActive带来的状态不同步问题：

import SwiftUI

// 定义导航目标枚举
enum NavDestination: Hashable {
    case viewB
}

struct ContentView: View {
    @State private var path = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $path) {
            ListView(path: $path)
                .navigationDestination(for: NavDestination.self) { destination in
                    switch destination {
                    case .viewB:
                        ViewB()
                    }
                }
        }
    }
}

struct ListView: View {
    @Binding var path: NavigationPath
    
    var body: some View {
        List {
            NavigationLink(destination: ViewA(path: $path), label: {
                Text("A")
            })
                
            NavigationLink(value: NavDestination.viewB, label: {
                Text("B")
            })
        }
    }
}

struct ViewA: View {
    @Binding var path: NavigationPath
    
    var body: some View {
        List {
            Button(action: {
                print("action from model")
                path.append(NavDestination.viewB)
            }, label: {
                Text("label")
            })
        }
        .navigationTitle("view a")
    }
}

struct ViewB: View {
    var body: some View {
        List {
            Button(action: {
                print("actionb")
            }, label: {
                Text("labelb")
            })
        }
        .navigationTitle("view b")
    }
}

方式二：修复isActive绑定的状态同步 #

如果需要保留原有isActive绑定逻辑，可通过监听返回事件手动重置状态：

struct ViewA: View {
    @StateObject var viewModel: Observed
    
    var body: some View {
        ZStack {
            List {
                Button(action: {
                    viewModel.action()
                }, label: {
                    Text("label")
                })
            }
            
            NavigationLink(isActive: $viewModel.shouldShowViewB, destination: {
                ViewB()
                    .onDisappear {
                        // 从ViewB返回时强制重置状态
                        viewModel.shouldShowViewB = false
                    }
            }, label: {EmptyView()})
        }
        .navigationTitle("view a")
        .onChange(of: viewModel.shouldShowViewB) { oldValue, newValue in
            // 半滑返回取消后同步状态
            if oldValue && !newValue {
                viewModel.shouldShowViewB = false
            }
        }
    }
}

说明 #

方式一的NavigationPath方案更适配现代SwiftUI导航逻辑，能灵活管理复杂导航栈；方式二则是针对原有代码的最小改动修复，适合快速适配场景。

内容的提问来源于stack exchange，提问作者Александр Нестеров