Firebase Messaging结合React Navigation点击通知跳转指定页偶发失效排查

问题根因分析 #

• 你提到的Android半关闭机制真实存在：Android 9及以上版本的*应用待机分组（App Standby Buckets）*功能，会对连续多日未使用的应用进行资源限制，包括下调后台服务、广播接收器的运行优先级，应用进程会被放入系统缓存状态。当应用从缓存状态恢复时，如果JS运行时上下文被部分回收，App.tsx中挂载的onNotificationOpenedApp监听器会直接失效，只有完全重启应用重新执行注册逻辑才能恢复，和你描述的故障表现完全匹配。
• 集成react-native-bootsplash可能加剧这个问题：如果你的启动页是独立Activity，通知点击的意图如果被启动页Activity拦截消费，没有传递给承载RN的主Activity，也会导致Firebase无法拿到通知内容，仅跳转首页。
• 旧通知重复触发的问题确实和getInitialNotification的实现机制有关：Firebase Messaging默认会持久化初始通知的内容，直到应用进程完全销毁重启，不会自动标记为已消费，每次调用getInitialNotification都会返回同一个历史通知，只要getInitialURL被多次触发，就会出现重复处理的情况。

修复方案 #

1. 解决长时间后台后通知跳转失效问题 #

• 统一跳转逻辑：将通知转deeplink的逻辑抽为公共方法，getInitialURL和onNotificationOpenedApp两个入口调用同一套逻辑，避免两端处理不一致导致的跳转失败。
• 调整监听器注册时机：不要将onNotificationOpenedApp的注册逻辑放在App组件的useEffect中，提前到index.js入口文件、原生模块初始化完成后就注册，避免组件挂载延迟导致的事件丢失。示例写法：

// index.js
import {AppRegistry} from 'react-native';
import App from './App';
import {name as appName} from './app.json';
import messaging from '@react-native-firebase/messaging';

// 提前注册后台点击通知监听器
messaging().onNotificationOpenedApp(remoteMessage => {
  if (!remoteMessage?.data) return;
  const {type, id} = remoteMessage.data;
  if (!id) return;
  // 这里可以用React Navigation的根导航ref调用跳转逻辑
  if (type === 'TRANSFER') {
    navigationRef.current?.navigate('Player', {id: Number(id)});
  } else {
    navigationRef.current?.navigate('Article', {id: Number(id)});
  }
});

AppRegistry.registerComponent(appName, () => App);

• 校验Android配置：检查AndroidManifest中的通知点击意图过滤器，确保配置在承载RN的主Activity中，不要配置在react-native-bootsplash的启动页Activity上；如果启动页需要单独处理，要在启动页关闭时将原始intent传递给主Activity。

2. 解决旧通知重复触发问题 #

• 手动消费初始通知：在getInitialURL中处理完通知跳转逻辑后，主动清空Firebase存储的初始通知，避免后续重复调用返回相同内容。示例修改后的getInitialURL逻辑：

getInitialURL: async () => {
  try {
    const url = await Linking.getInitialURL();
    if (url !== null) return url;

    const notification = await messaging().getInitialNotification();
    if (notification !== null) {
      const {data} = notification;
      // 处理完后主动清空初始通知，为v18+版本写法，低版本可根据自身依赖版本调整对应API
      messaging().setInitialNotification(null);
      if (data?.type === 'ARTICLE') {
        return `${rootUrl}/site/news/${data.id}`;
      }
      if (data?.type === 'TRANSFER') {
        return `${rootUrl}/site/player/${data.id}`;
      }
    }

    return null;
  } catch (error) {
    return null;
  }
}

• 增加去重校验：给每个通知添加唯一的messageId标识，将已处理过的通知id存在本地缓存，每次拿到新通知先判断是否已处理，已处理的直接跳过即可。

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