Swift Deeplink跳转至已启动App中已打开ViewController的解决方案咨询

这个问题我之前帮好几个开发者踩过坑，核心思路就是在处理Deeplink请求前，先检查当前导航栈（或模态链）里是否已经存在目标ViewController，然后分情况处理——要么直接给已有的VC传参刷新，要么把它移到栈顶，绝对不要重复实例化。下面是具体的实现步骤：

1. 先写个工具方法查找已存在的目标VC #

首先，给UINavigationController加个扩展，用来快速遍历栈内的VC，判断目标VC是否存在（假设你的目标VC叫TargetViewController）：

extension UINavigationController {
    func findExistingTargetVC() -> TargetViewController? {
        return viewControllers.first { $0 is TargetViewController } as? TargetViewController
    }
}

如果你的App用了TabBar，还要先获取当前选中的导航控制器：

// 获取当前活跃的导航控制器
guard let tabBarController = UIApplication.shared.keyWindow?.rootViewController as? UITabBarController,
      let currentNav = tabBarController.selectedViewController as? UINavigationController else {
    return
}
// 查找是否存在目标VC
let existingVC = currentNav.findExistingTargetVC()

2. 分情况处理Deeplink请求 #

找到已存在的VC后，就不用再创建新实例了，直接调用VC内部的方法更新参数和UI；如果不存在，再正常实例化推入栈：

// 假设你已经从Deeplink URL里解析出了参数
let deeplinkParams = parseDeeplinkParameters(from: url)

if let existingVC = existingVC {
    // 可选：如果VC不在栈顶，把它移到栈顶（符合用户预期，直接看到目标页面）
    currentNav.popToViewController(existingVC, animated: true)
    // 给已有的VC传递参数，刷新内容
    existingVC.updateContent(with: deeplinkParams)
} else {
    // 不存在目标VC，正常创建并推入栈
    let newVC = TargetViewController()
    newVC.setup(with: deeplinkParams)
    currentNav.pushViewController(newVC, animated: true)
}

这里要注意，updateContent(with:)是你自己在TargetViewController里定义的方法，用来接收参数并刷新UI，比如：

class TargetViewController: UIViewController {
    // ...其他代码
    
    func updateContent(with params: [String: Any]) {
        // 根据参数更新数据模型
        self.dataModel = DataModel(params: params)
        // 刷新UI
        self.tableView.reloadData()
        self.title = params["title"] as? String
    }
}

3. 处理App后台唤醒的情况 #

当App处于后台时被Deeplink唤醒，要确保在对应的回调方法里执行同样的检查逻辑。比如iOS 13+用SceneDelegate，iOS 12及以下用AppDelegate：

iOS 13+（SceneDelegate） #

func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
    guard let url = URLContexts.first?.url else { return }
    // 调用统一的Deeplink处理逻辑
    DeeplinkHandler.shared.handleDeeplink(url: url)
}

iOS 12及以下（AppDelegate） #

func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    DeeplinkHandler.shared.handleDeeplink(url: url)
    return true
}

4. 优化：统一Deeplink处理逻辑 #

建议把所有Deeplink的解析、VC检查逻辑抽成一个单例工具类，避免代码重复，也方便后续维护：

class DeeplinkHandler {
    static let shared = DeeplinkHandler()
    
    private init() {} // 私有初始化，确保单例
    
    func handleDeeplink(url: URL) {
        let params = parseParameters(from: url)
        guard let rootVC = UIApplication.shared.keyWindow?.rootViewController else { return }
        
        // 根据App结构获取当前活跃的导航控制器
        var currentNav: UINavigationController?
        if let tabBar = rootVC as? UITabBarController {
            currentNav = tabBar.selectedViewController as? UINavigationController
        } else if let nav = rootVC as? UINavigationController {
            currentNav = nav
        }
        
        guard let nav = currentNav else { return }
        if let existingVC = nav.findExistingTargetVC() {
            nav.popToViewController(existingVC, animated: true)
            existingVC.updateContent(with: params)
        } else {
            let newVC = TargetViewController()
            newVC.setup(with: params)
            nav.pushViewController(newVC, animated: true)
        }
    }
    
    // 解析Deeplink参数的工具方法
    private func parseParameters(from url: URL) -> [String: Any] {
        var params = [String: Any]()
        guard let components = URLComponents(url: url, resolvingAgainstBaseURL: false),
              let queryItems = components.queryItems else {
            return params
        }
        queryItems.forEach { item in
            params[item.name] = item.value
        }
        return params
    }
}

特殊情况处理：模态弹出的VC #

如果你的目标VC是通过模态方式弹出的，那就要遍历presentedViewController链来查找，比如写个递归方法：

func findPresentedTargetVC(from vc: UIViewController) -> TargetViewController? {
    if let targetVC = vc as? TargetViewController {
        return targetVC
    }
    if let presentedVC = vc.presentedViewController {
        return findPresentedTargetVC(from: presentedVC)
    }
    return nil
}

使用的时候：

if let existingVC = findPresentedTargetVC(from: rootVC) {
    // 刷新参数
    existingVC.updateContent(with: params)
    // 可选：把模态VC移到最上层
    existingVC.dismiss(animated: false) {
        rootVC.present(existingVC, animated: true)
    }
} else {
    // 正常模态弹出新VC
    let newVC = TargetViewController()
    rootVC.present(newVC, animated: true)
}

这样就能完美解决重复打开ViewController的问题，同时保证参数能正确传递给已有的实例。

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