React Native中Dynamic Links问题：onLink不触发，getInitialLink返回Null如何解决

一、先排查基础配置问题（90%的异常源于配置疏漏） #

Android端配置检查 #

• 确认AndroidManifest.xml中已添加正确的Intent Filter，匹配你的动态链接域名：

  <activity
    android:name=".MainActivity"
    android:launchMode="singleTask"> <!-- 必须设置为singleTask，避免重复启动实例 -->
    <intent-filter>
      <action android:name="android.intent.action.VIEW"/>
      <category android:name="android.intent.category.DEFAULT"/>
      <category android:name="android.intent.category.BROWSABLE"/>
      <data android:host="invertase.io" android:scheme="https"/>
    </intent-filter>
  </activity>
  

• 检查android/app/google-services.json是否正确放置，且文件内的包名与Firebase控制台配置完全一致。
• 确认android/build.gradle已引入Dynamic Links依赖：

  dependencies {
    // 其他依赖
    implementation 'com.google.firebase:firebase-dynamic-links'
  }
  

iOS端配置检查 #

• 在Info.plist中添加与Firebase控制台匹配的URL Scheme：

  <key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>your_app_scheme</string> <!-- 对应Firebase控制台的应用ID前缀，比如com.yourapp.app -->
      </array>
    </dict>
  </array>
  

• 在Xcode项目配置的Signing & Capabilities中启用Associated Domains，添加applinks:invertase.io（替换为你的动态链接域名）。
• 确认GoogleService-Info.plist已正确导入项目，且Bundle ID与Firebase控制台一致。

二、代码层面修复与优化 #

1. 完善getInitialLink的错误处理 #

原代码未捕获Promise异常，无法排查获取链接失败的原因，修改为：

const handleDynamicLink = (link) => {
  if (!link) return; // 防止null值报错
  console.log('Received link:', link);
  if (link.url === 'https://invertase.io/offer') {
    // 导航到优惠页面逻辑
  }
};

useEffect(() => {
  const fetchInitialLink = async () => {
    try {
      const link = await dynamicLinks().getInitialLink();
      console.log('Initial link:', link);
      if (link) handleDynamicLink(link);
    } catch (error) {
      console.error('Failed to get initial link:', error); // 打印错误定位问题
    }
  };
  fetchInitialLink();
}, []);

2. 确保onLink监听器稳定注册 #

避免因Firebase初始化延迟导致监听器注册失败，调整为异步初始化逻辑：

useEffect(() => {
  let unsubscribe;
  const setupLinkListener = async () => {
    // 确保Firebase已完成初始化
    unsubscribe = dynamicLinks().onLink(handleDynamicLink);
  };
  setupLinkListener();

  return () => {
    if (unsubscribe) unsubscribe(); // 组件卸载时移除监听器
  };
}, []);

三、场景化测试与验证 #

• 冷启动场景：完全关闭APP后点击动态链接，此时应触发getInitialLink，若返回null，优先检查Android的launchMode配置或iOS的Associated Domains。
• 热启动场景：APP在后台运行时点击链接，此时应触发onLink，若未触发，检查监听器是否被提前卸载，或是否有其他逻辑覆盖了链接监听。
• 用命令行验证Android深层链接：

  adb shell am start -W -a android.intent.action.VIEW -d "https://invertase.io/offer"
  

  若APP能正常打开但仍获取不到链接，说明配置存在深层问题。

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