SwiftUI混合UIKit项目中从SwiftUI.View触发Push UIViewController失败如何解决

你当前AppData中获取导航控制器的逻辑存在场景限制：

• 当UITabBarController作为window根视图时，它的直接子控制器是每个Tab独立对应的UINavigationController
• 现有代码window?.rootViewController?.children.first取到的永远是第一个Tab的导航控制器，切换到其他Tab后，向这个导航控制器push页面不会作用于当前展示的Tab，自然看不到跳转效果。

方案1：修正全局导航控制器获取逻辑 #

调整AppData中获取当前活跃导航控制器的逻辑，适配多Tab场景：

final class AppData: ObservableObject {
    weak var window: UIWindow? 

    init(window: UIWindow? = nil) {
        self.window = window
    }
    
    // 获取当前最顶层的活跃控制器
    private var topMostViewController: UIViewController? {
        guard let root = window?.rootViewController else { return nil }
        var top = root
        while let presented = top.presentedViewController {
            top = presented
        }
        return top
    }
    
    public func pushViewController(_ viewController: UIViewController, animated: Bool = true) {
        // 从当前顶层控制器取所属的导航控制器
        guard let nvc = topMostViewController?.navigationController else { return }
        // 确保UI操作在主线程执行
        DispatchQueue.main.async {
            nvc.pushViewController(viewController, animated: animated)
        }
    }
}

方案2：无全局依赖的环境变量注入方案 #

通过SwiftUI环境变量传递当前宿主的导航控制器，逻辑更解耦：

1. 定义导航控制器环境Key

struct NavigationControllerKey: EnvironmentKey {
    static let defaultValue: UINavigationController? = nil
}

extension EnvironmentValues {
    var navigationController: UINavigationController? {
        get { self[NavigationControllerKey.self] }
        set { self[NavigationControllerKey.self] = newValue }
    }
}

2. 在自定义UIHostingController中注入环境变量

class CustomHostingController<Content: View>: UIHostingController<Content> {
    override func viewDidLoad() {
        super.viewDidLoad()
        // 将当前所属的导航控制器注入SwiftUI环境
        let injectedView = rootView.environment(\.navigationController, navigationController)
        rootView = injectedView
    }
}

3. SwiftUI视图内直接调用跳转

struct YourSwiftUIView: View {
    @Environment(\.navigationController) private var navigationController
    
    var body: some View {
        Button("跳转页面") {
            let vc = UIHostingController(rootView: RootView())
            navigationController?.pushViewController(vc, animated: true)
        }
    }
}

• 确认Storyboard中每个Tab关联的是独立的UINavigationController，不要出现多Tab共用同一个导航控制器的配置
• 所有UI操作需确保在主线程执行，避免异步逻辑触发跳转导致无响应
• 若UIHostingController直接作为导航控制器根视图，可在viewDidAppear阶段再次校验navigationController属性是否非空，避免注入时机过早导致的空值问题

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