React Native iOS端如何获取UINavigationController实例？

核心结论 #

不能直接新建UINavigationController，必须获取React Native/Expo应用的已有导航实例——否则会打破现有导航栈结构，引发页面跳转异常、状态丢失等问题。

具体实现方案 #

1. 通过React Native工具类获取根控制器并查找导航实例 #

借助React Native的RCTUtils工具类，先拿到应用的根视图控制器，再递归查找顶层的UINavigationController：

import React

public func onThreeDSChallengeRequired(completion: @escaping (UINavigationController) -> Void) {
    guard let rootViewController = RCTKeyWindow()?.rootViewController else {
        // 处理根控制器不存在的异常场景
        return
    }
    
    // 定位当前活跃的UINavigationController
    var targetNavController: UINavigationController?
    // 先判断根控制器本身是否是导航控制器
    if let nav = rootViewController as? UINavigationController {
        targetNavController = nav
    }
    // 再检查是否是被present出来的导航控制器
    else if let presentedNav = rootViewController.presentedViewController as? UINavigationController {
        targetNavController = presentedNav
    }
    // 以上都不满足时，递归遍历视图层级查找
    else {
        targetNavController = rootViewController.findTopNavigationController()
    }
    
    if let nav = targetNavController {
        completion(nav)
    } else {
        // 极端 fallback 方案：临时创建导航控制器（仅万不得已时使用）
        let fallbackNav = UINavigationController()
        completion(fallbackNav)
    }
}

// 扩展UIViewController，实现递归查找顶层导航控制器的逻辑
extension UIViewController {
    func findTopNavigationController() -> UINavigationController? {
        if let nav = self as? UINavigationController {
            return nav
        }
        // 遍历子控制器
        for child in children {
            if let foundNav = child.findTopNavigationController() {
                return foundNav
            }
        }
        // 检查被present的控制器
        return presentedViewController?.findTopNavigationController()
    }
}

2. 适配Expo自定义客户端的特殊根结构 #

Expo自定义客户端的根控制器通常是EXShellAppViewController，它内部包裹了React Native的视图层级，可以针对性调整查找逻辑：

// 针对Expo自定义客户端的根控制器处理
if let shellVC = rootViewController as? EXShellAppViewController {
    targetNavController = shellVC.viewControllers.first as? UINavigationController
}

注：需确保已导入Expo相关头文件，若不想直接依赖具体类，也可通过字符串匹配类型名的方式处理。

关键注意事项 #

• 坚决避免直接新建UINavigationController：新建的实例不属于React Navigation管理的栈，会导致3DS挑战完成后无法正常回到原应用页面，甚至引发内存泄漏。
• 同步React Navigation状态：React Navigation在iOS端基于UINavigationController实现，只有使用现有实例，才能保证原生导航行为和RN侧的导航状态一致。
• 必须处理异常场景：务必做好找不到导航控制器的容错逻辑，避免应用崩溃。

内容的提问来源于stack exchange，提问作者Obay Abd-Algader