Flow Coordinator模式与.sheet导致NavigationStack Push动画消失问题

在SwiftUI中使用NavigationStack结合Flow Coordinator模式（通过ObservableObject管理NavigationPath）时，先通过.sheet弹出视图再关闭后，NavigationStack的默认push动画会消失。直接将NavigationPath作为@State属性使用时则无此问题。相关代码如下：

import SwiftUI

class Coordinator:ObservableObject {
    @Published var path = NavigationPath()
    
    func pushColorView(){
        path.append("colorView")
    }
}

@main
struct TestApp: App {
    @StateObject var coordinator = Coordinator()
    @State var isPresented = false
    
    //@State var path = NavigationPath()  //<-- 使用此时代码运行正常
    
    var body: some Scene {
        WindowGroup {
            NavigationStack(path: $coordinator.path){
           // NavigationStack(path: $path){  //<-- 使用此时代码运行正常
                VStack{
                    Button("present with sheet") {
                        isPresented = true
                    }
                    .sheet(isPresented: $isPresented) {
                        PopView()
                    }
                    Button("push"){
                        coordinator.pushColorView()
                    //  path.append("colorView") //<-- 使用此时代码运行正常
                    }
                }
                .navigationDestination(for: String.self) { destination in
                    Color.blue
                }
            }
            .environmentObject(coordinator)
        }
    }
}

struct PopView: View {
    @Environment(\.dismiss) var dismiss
    var body: some View {
        VStack{
            Button("Back to Main") {
                dismiss()
            }
        }
    }
}

原因 #

这是SwiftUI的已知行为：当用ObservableObject包装NavigationPath时，sheet的弹出与关闭会干扰主视图树对Coordinator状态的订阅逻辑。关闭sheet后，主视图重新订阅Coordinator的@Published属性时，状态更新的时机与视图树的动画触发机制不同步，导致SwiftUI无法识别到需要执行push过渡动画。而@State是SwiftUI原生状态管理，与视图树生命周期绑定更紧密，不会出现此类同步问题。

解决方案 #

方案1：用@MainActor标记状态更新方法 #

确保Coordinator的状态更新在主线程执行，让SwiftUI正确捕获状态变化并触发动画：

class Coordinator:ObservableObject {
    @Published var path = NavigationPath()
    
    @MainActor
    func pushColorView(){
        path.append("colorView")
    }
}

方案2：显式在主线程执行状态更新 #

在调用push方法时，强制在主线程调度：

Button("push"){
    DispatchQueue.main.async {
        coordinator.pushColorView()
    }
}

方案3：显式发送状态变更通知 #

手动触发objectWillChange通知，确保SwiftUI及时感知状态变化：

class Coordinator:ObservableObject {
    @Published var path = NavigationPath()
    
    func pushColorView(){
        objectWillChange.send()
        path.append("colorView")
    }
}

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