React Native集成Firebase动态链接iOS扫码跳转页面失效问题咨询

这个问题和iOS原生侧的Universal Link回调配置、导航实例初始化时机都有关系，两种唤醒场景的底层链路不同导致表现差异：

• 系统相机扫码直接打开应用走的是Universal Link唤醒链路，如果原生层没有把该链路的参数正确传递给Firebase动态链接模块，JS侧就拿不到链接参数，自然不会触发跳转
• 浏览器预览页点击「打开」按钮走的是自定义URL Scheme唤醒链路，该链路的回调默认在React Native项目初始化时就已配置完成，所以能正常拿到参数跳转

1. 补全iOS原生侧Universal Link回调处理 #

打开iOS项目的AppDelegate.m（OC项目）或AppDelegate.swift（Swift项目），添加Firebase动态链接的Universal Link处理逻辑：

// AppDelegate.m 需引入头文件
#import <FirebaseDynamicLinks/FIRDynamicLinks.h>

// 添加如下方法
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity restorationHandler:(void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler {
  if ([userActivity.activityType isEqualToString:NSUserActivityTypeBrowsingWeb]) {
    NSURL *webpageURL = userActivity.webpageURL;
    // 把Universal Link参数传递给Firebase动态链接模块
    if ([[FIRDynamicLinks dynamicLinks] handleUniversalLink:webpageURL completion:^(FIRDynamicLink * _Nullable dynamicLink, NSError * _Nullable error) {
      // 处理结果会自动同步到RN侧的动态链接监听接口
    }]) {
      return YES;
    }
  }
  return YES;
}

2. 优化导航调用时机，避免初始化时序问题 #

你当前用的基于ref的RootNavigation，冷启动场景下可能出现动态链接处理逻辑执行时，导航实例还没挂载完成，navigationRef.current为null导致跳转静默失败，修改JS侧逻辑增加重试兜底：

// App.js 新增导航就绪等待方法
const navigateWhenReady = (name, params, retryCount = 0) => {
  if (RootNavigation.navigationRef.current) {
    RootNavigation.navigate(name, params);
  } else if (retryCount < 20) {
    // 每50ms重试一次，最多等待1s，足够覆盖导航初始化耗时
    setTimeout(() => navigateWhenReady(name, params, retryCount + 1), 50);
  }
};

// 修改handleDynamicLink里的跳转逻辑
const handleDynamicLink = link => {
  if (!link?.url) return; // 先判空避免冷启动时link为null报错
  const linkCheck = new RegExp('^https://example.page.link/.*$');
  let title;

  if (linkCheck.test(link.url)) {
    title = link.url.substring(link.url.lastIndexOf('/') + 1).split('-');
    navigateWhenReady(Screens.offer, { title: title });
  }
};

3. 验证基础配置正确性 #

• 确认Xcode项目的Signing & Capabilities中已添加Associated Domains，且域名配置为applinks:example.page.link
• 确认Firebase控制台动态链接配置页的iOS应用Bundle ID、Team ID和你项目的实际配置完全一致

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