如何阻止SwiftUI视图在onViewWillDisappear触发时自动返回上一级界面

根因说明 #

你遇到的非预期自动回退，本质是Published变量变更触发视图全局重绘，导航状态绑定（NavigationLink的isActive或NavigationStack的path）被意外重置，系统触发自动出栈。

方案1：iOS 16+ NavigationStack路径拦截 #

直接在导航栈的路径绑定层做统一拦截，优先级最高：

• 首先在视图模型中声明导航状态和拦截标记

class PageViewModel: ObservableObject {
    @Published var navPath = NavigationPath()
    // 无关的业务变量
    @Published var businessData: String = ""
    // 导航出栈允许标记
    var allowPopAction = true
}

• 视图层重写导航栈的transaction拦截逻辑

struct AppMainPage: View {
    @StateObject private var vm = PageViewModel()
    
    var body: some View {
        NavigationStack(path: $vm.navPath) {
            RootListView()
                .navigationDestination(for: NavRoute.self) { route in
                    switch route {
                    case .targetPage:
                        TargetPageView()
                            .onViewWillDisappear {
                                // 视图即将消失时关闭出栈允许开关
                                vm.allowPopAction = false
                            }
                    }
                }
        }
        .transaction { transaction in
            // 所有导航变更都会触发该回调
            guard vm.allowPopAction else {
                // 拦截非预期出栈，禁用导航变更
                transaction.disablesAnimations = true
                return
            }
        }
    }
}

方案2：iOS 15及以下 NavigationLink绑定拦截 #

针对基于NavigationLink(isActive:)的导航场景，直接修改isActive绑定的set逻辑做拦截：

struct ParentPageView: View {
    @State private var showChildPage = false
    @State private var allowNavChange = true
    
    var body: some View {
        NavigationView {
            Button("打开子页面") {
                showChildPage = true
            }
            .background(
                NavigationLink(
                    isActive: Binding(
                        get: { showChildPage },
                        set: { newValue in
                            // 仅允许标记为可用时修改导航状态
                            guard allowNavChange else { return }
                            showChildPage = newValue
                        }
                    ),
                    destination: {
                        ChildPageView()
                            .onViewWillDisappear {
                                allowNavChange = false
                            }
                    }
                )
            )
        }
    }
}

附加用户主动返回拦截豁免逻辑 #

如果需要保留用户主动点击返回、侧滑返回的正常行为，可以扩展View监听返回事件，修改拦截标记即可，避免拦截正常操作：

extension View {
    func onUserPopAction(action: @escaping () -> Void) -> some View {
        self.modifier(BackActionModifier(callback: action))
    }
}

*上述Modifier通过监听UIViewController的返回按钮点击、侧滑返回手势触发回调，触发时将拦截标记设为true即可豁免正常操作的出栈。

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