SwiftUI导航在@StateObject值变更时失效的模块化问题排查

问题背景 #

采用模块化架构拆分Login、Register、Profile等功能模块，避免模块间直接依赖，因此在根视图ContentView中统一处理导航逻辑。通过SplashViewModel的shouldNavigate状态控制从SplashView切换到IntroView，打印显示状态已正确变更，但目标视图始终未加载。

现有代码 #

ContentView代码 #

struct ContentView: View {
    @State private var shouldNavigateToIntro = false
    var viewModel = SplashDI.shared.splashDependencies()
    
    init() {
        viewModel.$shouldNavigate.sink { [self] shouldNavigate in
            DispatchQueue.main.async {
                self.shouldNavigateToIntro = shouldNavigate
                print(shouldNavigate)
            }
        }.store(in: &viewModel.bag)
    }
    
    var body: some View {
        NavigationStack {
                if shouldNavigateToIntro {
                    IntroView()
                } else {
                    SplashView(viewModel: viewModel)
                }
        }
    }
}

SplashViewModel代码 #

public final class SplashViewModel: ObservableObject {
    
    @Published public var shouldNavigate: Bool = false
    @Published var configs: TMConfig?
    public var bag = Set<AnyCancellable>()

    private let useCase: SplashUseCaseInterface
    
    public init(useCase: SplashUseCaseInterface) {
        self.useCase = useCase
    }

    
    @MainActor func getConfigs() {
            Task {
                do {
                    self.configs = try await useCase.getConfigs()
                    DispatchQueue.main.asyncAfter(deadline: .now() + .seconds(5), execute: {
                        self.shouldNavigate = true
                    })
                } catch {
                    self.configs = nil
                    print("Errorrrr: \(error)")
                }
            }
        }
}

问题原因分析 #

1. 状态更新未触发视图刷新：在init中订阅状态时，捕获的self是ContentView的初始实例，直接修改@State变量无法正确触发SwiftUI的视图刷新机制。
2. NavigationStack内视图切换逻辑问题：直接通过布尔值替换NavigationStack内的根视图，可能因视图身份标识问题导致刷新失效。
3. ViewModel生命周期管理不当：未使用@StateObject管理ViewModel，可能导致状态订阅与视图生命周期脱节。

解决方案 #

方案1：修复状态订阅与视图刷新 #

将订阅逻辑移到视图生命周期方法中，用@StateObject绑定ViewModel：

struct ContentView: View {
    @State private var shouldNavigateToIntro = false
    @StateObject var viewModel = SplashDI.shared.splashDependencies()
    
    var body: some View {
        NavigationStack {
            Group {
                if shouldNavigateToIntro {
                    IntroView()
                } else {
                    SplashView(viewModel: viewModel)
                }
            }
            .onAppear {
                viewModel.$shouldNavigate
                    .receive(on: DispatchQueue.main)
                    .assign(to: \.shouldNavigateToIntro, on: self)
                    .store(in: &viewModel.bag)
                
                Task {
                    await viewModel.getConfigs()
                }
            }
        }
    }
}

方案2：使用NavigationStack路径管理（推荐） #

利用NavigationStack的path绑定管理导航栈，更符合SwiftUI设计范式，且能轻松清空导航栈：

// 定义全局导航路径枚举，避免模块间依赖
enum NavigationRoute: Hashable {
    case intro
    // 可扩展添加.login、.register等路由
}

struct ContentView: View {
    @StateObject var viewModel = SplashDI.shared.splashDependencies()
    @State private var navigationPath = NavigationPath()
    
    var body: some View {
        NavigationStack(path: $navigationPath) {
            SplashView(viewModel: viewModel)
                .navigationDestination(for: NavigationRoute.self) { route in
                    switch route {
                    case .intro:
                        IntroView()
                    }
                }
        }
        .onReceive(viewModel.$shouldNavigate) { shouldNavigate in
            if shouldNavigate {
                navigationPath.append(.intro)
                // 清空导航栈可使用：navigationPath = NavigationPath()
            }
        }
    }
}

// 优化ViewModel的主线程处理
public final class SplashViewModel: ObservableObject {
    // 保留原有属性与初始化方法
    
    @MainActor func getConfigs() {
        Task {
            do {
                self.configs = try await useCase.getConfigs()
                try await Task.sleep(nanoseconds: 5 * 1_000_000_000)
                self.shouldNavigate = true
            } catch {
                self.configs = nil
                print("Errorrrr: \(error)")
            }
        }
    }
}

模块化导航注意事项 #

• 用全局路由枚举统一管理页面跳转，所有导航逻辑由根视图处理，避免模块间直接依赖。
• 始终用@StateObject管理ViewModel，确保其生命周期与视图绑定。
• 优先使用NavigationStack的path机制实现导航，而非直接替换根视图，更贴合SwiftUI的导航设计。

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