iOS应用Universal Link可正常拉起应用但未触发回调处理函数

可能的原因及排查方案 #

1. 冷启动场景参数接收逻辑遗漏 #

当应用完全处于未启动状态（后台无存活进程）时，Universal Link拉起应用的参数不会直接触发application(_:continue:restorationHandler:)回调，而是会通过UIApplicationLaunchOptionsUserActivityKey携带到application(_:didFinishLaunchingWithOptions:)方法的launchOptions参数中。
你需要在该方法中提前处理对应参数，示例代码如下：

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 提取冷启动时的Universal Link参数
    if let userActivity = launchOptions?[.userActivity] as? NSUserActivity,
       userActivity.activityType == NSUserActivityTypeBrowsingWeb,
       let url = userActivity.webpageURL {
        // 此处调用你自己的URL处理逻辑
        handleUniversalLink(url)
    }
    return true
}

2. Info.plist残留Scene配置导致回调路由错误 #

如果你的项目是从高版本Xcode默认模板创建，即使你删除了SceneDelegate相关代码，只要Info.plist中还存在Application Scene Manifest配置项，系统就会默认走Scene生命周期的回调，不会将Universal Link事件转发到AppDelegate的对应方法。
排查方案：直接删除Info.plist中的Application Scene Manifest条目即可。

3. 第三方SDK拦截了回调 #

多数社交分享、支付、登录类SDK会hook Universal Link的回调方法用于处理自身的跳转逻辑，如果SDK内部处理完成后直接返回了true，且未提供回调透传能力，会导致上层AppDelegate无法收到对应事件。
排查方案：暂时移除所有第三方SDK的初始化逻辑，单独测试Universal Link回调是否能正常触发，如果恢复正常则需要对应SDK提供事件透传接口，或者调整SDK初始化顺序，保证你自己的逻辑优先处理。

4. 方法签名错误/方法归属错误 #

检查application(_:continue:restorationHandler:)方法是否直接定义在AppDelegate主类中，而非分类/扩展内；同时检查方法签名是否完全匹配系统要求，参数、返回值是否存在书写错误。

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