Deep Link通知处理异常：URL传递至ViewController偶发失效求助

我明白你遇到的问题——用通知传递Deep Link URL确实经常会因为ViewController的生命周期问题导致不稳定，比如冷启动时VC还没完成初始化，通知发出去根本没人接收。下面给你几个更靠谱的解决方案，从简单易实现到架构层面优化的都有：

方案一：用单例存储待处理的Deep Link URL #

这个方案能解决冷启动时VC未加载导致的通知丢失问题，核心思路是先把URL存起来，等VC加载完成后再去读取处理。

1. 创建单例管理类 #

class DeepLinkManager {
    // 全局单例实例
    static let shared = DeepLinkManager()
    // 存储待处理的URL，私有set保证只有内部能修改
    private(set) var pendingURL: URL?
    
    // 设置待处理URL
    func setPendingURL(_ url: URL) {
        pendingURL = url
    }
    
    // 处理完后清空URL，避免重复处理
    func clearPendingURL() {
        pendingURL = nil
    }
}

2. 修改AppDelegate中的处理逻辑 #

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
    // 先把URL存到单例里
    DeepLinkManager.shared.setPendingURL(url)
    
    // 如果App已经在前台，再发通知触发即时处理
    NotificationCenter.default.post(name: NSNotification.Name("DeepLinkReceived"), object: url)
    return true
}

// 别忘了处理冷启动时的Deep Link（从launchOptions里获取）
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    if let url = launchOptions?[.url] as? URL {
        DeepLinkManager.shared.setPendingURL(url)
    }
    return true
}

3. 在目标ViewController中处理 #

class YourTargetVC: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        
        // 检查单例里有没有待处理的URL
        if let pendingURL = DeepLinkManager.shared.pendingURL {
            handleDeepLink(pendingURL)
            DeepLinkManager.shared.clearPendingURL()
        }
        
        // 注册通知，处理App前台时的Deep Link
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(handleDeepLinkNotification(_:)),
            name: NSNotification.Name("DeepLinkReceived"),
            object: nil
        )
    }
    
    // 处理通知传递的URL
    @objc private func handleDeepLinkNotification(_ notification: Notification) {
        guard let url = notification.object as? URL else { return }
        handleDeepLink(url)
    }
    
    // 统一的Deep Link处理逻辑
    private func handleDeepLink(_ url: URL) {
        // 这里写你的业务逻辑，比如解析URL参数、跳转页面等
        print("处理Deep Link: \(url.absoluteString)")
    }
    
    // 记得移除通知观察者，避免内存泄漏
    deinit {
        NotificationCenter.default.removeObserver(self)
    }
}

方案二：iOS13+ 用SceneDelegate直接传递URL #

如果你的App支持iOS13及以上，苹果推荐用SceneDelegate来处理场景相关的事件，包括Deep Link，这样能更精准地获取当前活跃的ViewController。

class SceneDelegate: UIResponder, UIWindowSceneDelegate {
    var window: UIWindow?

    func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
        guard let url = URLContexts.first?.url else { return }
        
        // 直接找到目标ViewController并传递URL
        if let navVC = window?.rootViewController as? UINavigationController,
           let targetVC = navVC.topViewController as? YourTargetVC {
            targetVC.handleDeepLink(url)
        } else {
            // 如果目标VC还没加载，还是用单例存起来
            DeepLinkManager.shared.setPendingURL(url)
        }
    }
}

方案三：用Coordinator模式优雅管理（适合中大型App） #

如果你的App页面结构比较复杂，推荐用Coordinator模式统一管理页面跳转和Deep Link处理，能避免ViewController之间的耦合，让代码更易维护。

1. 创建AppCoordinator #

class AppCoordinator {
    private let window: UIWindow
    
    init(window: UIWindow) {
        self.window = window
        start()
    }
    
    // 初始化根页面
    func start() {
        let rootVC = YourRootVC()
        rootVC.coordinator = self
        window.rootViewController = UINavigationController(rootViewController: rootVC)
        window.makeKeyAndVisible()
        
        // 启动时检查有没有待处理的Deep Link
        if let pendingURL = DeepLinkManager.shared.pendingURL {
            handleDeepLink(pendingURL)
            DeepLinkManager.shared.clearPendingURL()
        }
    }
    
    // 统一处理Deep Link逻辑
    func handleDeepLink(_ url: URL) {
        // 解析URL路径和参数，比如根据path跳转不同页面
        switch url.path {
        case "/product":
            let productVC = ProductViewController()
            // 提取URL参数
            if let productId = url.queryParameters?["id"] {
                productVC.productId = productId
            }
            // 跳转页面
            if let navVC = window.rootViewController as? UINavigationController {
                navVC.pushViewController(productVC, animated: true)
            }
        // 其他路径的处理逻辑
        default:
            break
        }
    }
}

// 给URL加个扩展，方便解析参数
extension URL {
    var queryParameters: [String: String]? {
        guard let components = URLComponents(url: self, resolvingAgainstBaseURL: true),
              let queryItems = components.queryItems else { return nil }
        return queryItems.reduce(into: [String: String]()) { result, item in
            result[item.name] = item.value
        }
    }
}

2. 在AppDelegate中初始化Coordinator #

class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?
    var coordinator: AppCoordinator?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        window = UIWindow(frame: UIScreen.main.bounds)
        coordinator = AppCoordinator(window: window!)
        
        // 处理冷启动的Deep Link
        if let url = launchOptions?[.url] as? URL {
            DeepLinkManager.shared.setPendingURL(url)
        }
        return true
    }
    
    func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
        coordinator?.handleDeepLink(url)
        return true
    }
}

最后提醒几个注意点 #

• 确保在Info.plist中正确配置了你的URL Scheme，否则系统不会把Deep Link传递给你的App。
• 测试时要覆盖冷启动和App前台运行两种场景，避免遗漏情况。
• 如果用通知，一定要在deinit中移除观察者，防止内存泄漏。

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