iOS通用链接App未在后台时仅生效一次，后台运行正常如何解决？

核心问题根因 #

你的代码踩了两个Universal Link实现的典型时序与接口误用坑，直接触发了iOS系统对被杀App的唤起保护机制：

• 冷启动参数读取接口完全用错，将自定义URL Scheme的判断逻辑套用到了Universal Link场景
• 没有走完系统要求的用户活动恢复流程，导致iOS判定App未正确响应链接，临时拦截后续的Universal Link唤起事件

分步骤修正方案 #

1. 修正冷启动阶段的Universal Link参数解析 #

你当前在didFinishLaunchingWithOptions中通过UIApplication.LaunchOptionsKey.url读取启动URL的逻辑，仅对自定义URL Scheme生效，Universal Link冷启动的参数不会写入这个key，会一直走else分支初始化根控制器，导致时序混乱。
调整逻辑为：

• 先解析UIApplication.LaunchOptionsKey.userActivityDictionary中的NSUserActivity对象，识别Universal Link冷启动场景
• 无论是否存在待跳转的Universal Link，都先完成UIWindow、默认根控制器的初始化流程，不要直接分支跳过启动初始化
• 将待处理的Universal Link URL缓存为成员变量，等根控制器完全加载完成后再执行跳转，避免冷启动阶段窗口未就绪的时序问题

示例修正代码：

// 在AppDelegate中新增成员变量缓存待跳转URL
private var pendingUniversalLinkURL: URL?

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 解析Universal Link冷启动参数
    if let userActivityDict = launchOptions?[.userActivityDictionary] as? [String: Any],
       let userActivity = userActivityDict[.userActivity] as? NSUserActivity,
       userActivity.activityType == NSUserActivityTypeBrowsingWeb,
       let webpageURL = userActivity.webpageURL {
        pendingUniversalLinkURL = webpageURL
    }
    
    // 固定走统一的窗口初始化流程，不要分叉跳过
    self.window = UIWindow(frame: UIScreen.main.bounds)
    let initialVC = UIStoryboard(name: "Main", bundle: nil).instantiateViewController(withIdentifier: "MainTabBarViewController")
    self.window?.rootViewController = initialVC
    self.window?.makeKeyAndVisible()
    
    // 等视图加载完成后再处理缓存的跳转URL
    if let pendingURL = pendingUniversalLinkURL {
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.1) {
            self.continueWithLink(url: pendingURL)
            self.pendingUniversalLinkURL = nil
        }
    }
    return true
}

2. 补全用户活动回调的系统流程 #

你当前的application(_:continue:restorationHandler:)方法没有正确走完系统要求的恢复流程，iOS会判定App未正确处理传入的用户活动，触发后续的唤起拦截。
调整逻辑为：

• 校验userActivity的类型，确保是网页浏览类型的Universal Link
• 正确调用传入的restorationHandler，将当前的根控制器作为恢复对象传入，告知系统已完成活动恢复
• 跳转逻辑放到主队列异步执行，避免冷启动阶段窗口未初始化的时序问题

示例修正代码：

func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
    // 校验是否为Universal Link类型的活动
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb,
          let webpageURL = userActivity.webpageURL else {
        restorationHandler(nil)
        return false
    }
    // 标记活动已处理，避免系统重复下发
    userActivity.needsSave = false
    
    // 异步执行跳转，等窗口就绪后再操作
    DispatchQueue.main.async {
        self.continueWithLink(url: webpageURL)
    }
    
    // 正确调用恢复回调，走完系统流程
    if let rootVC = window?.rootViewController {
        restorationHandler([rootVC])
    } else {
        restorationHandler(nil)
    }
    return true
}

3. 优化跳转逻辑的时序适配 #

你当前的continueWithLink方法直接替换rootViewController的逻辑，没有考虑冷启动阶段的控制器加载状态：

• 不要在冷启动初始化阶段直接打断默认根控制器的创建流程，否则会导致系统判定App启动不完整，触发“仅唤起一次”的保护机制
• 替换rootViewController前，先确认当前窗口已经完成makeKeyAndVisible的流程，避免控制器渲染异常
• 保留原有BannedViewController的拦截判断，不做调整

额外排查点 #

如果修正后仍存在仅生效一次的问题，检查：

• 关联域名的apple-app-site-association文件是否配置正确，没有格式错误
• 是否在Info.plist中正确配置了Associated Domains，没有漏填applinks字段
• 测试时不要用Safari输入链接的方式唤起，要用短信、备忘录、第三方App内置浏览器等外部App的点击场景测试，避免Safari的域名缓存影响测试结果

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