React Native中iOS端Firebase通知DeepLink跳转失效问题求助

• 先验证DeepLink基础功能是否正常
  检查Info.plist里的CFBundleURLTypes配置，确保自定义scheme已正确添加：

  <key>CFBundleURLTypes</key>
  <array>
    <dict>
      <key>CFBundleTypeRole</key>
      <string>Editor</string>
      <key>CFBundleURLSchemes</key>
      <array>
        <string>your-app-scheme</string>
      </array>
    </dict>
  </array>
  

  直接在Safari输入your-app-scheme://test，看是否能唤起App并触发跳转逻辑——如果这一步都失败，先解决DeepLink本身的问题，再排查通知跳转。

• 核对Firebase通知Payload配置
  iOS端通知必须带apns字段开启可变内容，同时deeplink要放在data域里，示例请求体：

  {
    "to": "DEVICE_TOKEN",
    "notification": {
      "title": "测试通知",
      "body": "点击跳转详情"
    },
    "data": {
      "deeplink": "your-app-scheme://screen/detail/123"
    },
    "apns": {
      "payload": {
        "aps": {
          "mutable-content": 1
        }
      }
    }
  }
  

  用Firebase控制台发通知时，要把deeplink填在「额外选项」的「自定义数据」里，别放在通知内容字段中。

• 检查React Native端的通知点击逻辑
  必须同时处理App在前台/后台、以及完全关闭时的通知点击事件：

  // 处理App未完全关闭时的通知点击
  firebase.messaging().onNotificationOpenedApp((remoteMessage) => {
    const deepLink = remoteMessage.data.deeplink;
    if (deepLink) {
      // 替换成你的导航逻辑，比如React Navigation的navigate方法
      navigation.navigate('DetailScreen', { id: extractIdFromLink(deepLink) });
    }
  });
  
  // 处理App完全关闭后点击通知启动的情况
  firebase.messaging().getInitialNotification().then((remoteMessage) => {
    if (remoteMessage) {
      const deepLink = remoteMessage.data.deeplink;
      if (deepLink) {
        navigation.navigate('DetailScreen', { id: extractIdFromLink(deepLink) });
      }
    }
  });
  

  确认导航实例在初始化时已正确获取，避免出现navigation未定义的情况。

• 核对APNs证书与Firebase配置

  • 检查Firebase控制台的iOS应用配置，上传的APNs证书必须是推送证书（不是开发证书），且bundle ID与App完全一致。
  • 确认GoogleService-Info.plist已正确添加到Xcode项目中，且文件里的REVERSED_CLIENT_ID对应的scheme已加入Info.plist的CFBundleURLSchemes数组。

• 测试注意事项

  • 别用Firebase控制台的「测试消息」功能，部分自定义字段可能无法正常下发，建议用Postman调用FCM API发送测试通知。
  • iOS端必须用真实设备测试，模拟器无法接收APNs通知。

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