React Native Firebase本地通知不显示问题排查求助

嘿，针对你遇到的React Native本地通知部分用户收不到的问题，我结合你使用的RN 0.61.5和react-native-firebase 5.5.6版本，整理了一些实用的排查方向和修复方案，希望能帮到你：

一、可能的问题根源 #

1. 设备权限与系统限制 #

• iOS：用户可能首次启动时拒绝了通知权限，或者后续在设置里关掉了；iOS 13+的专注模式（原屏幕使用时间）也可能直接屏蔽了应用通知。
• Android：用户关闭了应用通知权限是常见情况，另外像小米、华为这类国产ROM的后台省电/清理机制会直接杀死RN进程，导致定时通知的调度逻辑完全失效。

2. 依赖版本兼容性漏洞 #

你用的react-native-firebase 5.5.6是比较老的版本，虽然和RN 0.61.5基本兼容，但对iOS 14+、Android 10+这类较新系统的适配可能存在遗漏，导致通知触发逻辑在新系统上跑不通。

3. 本地通知调度逻辑bug #

• 时区处理错误：比如你用UTC时间调度，但用户设备是本地时区，导致通知触发时间偏差，根本没到点；
• 通知ID冲突：重复用同一个ID会覆盖之前的调度，旧通知直接被冲掉；
• Android后台任务限制：Android 8.0+对后台任务管控极严，react-native-firebase/notifications依赖的后台服务可能被系统强制回收，导致定时任务执行失败。

4. 应用进程被彻底杀死 #

• Android：厂商系统会在应用退到后台后自动清理进程，没有进程的话，本地通知的定时逻辑自然无法运行；
• iOS：如果用户强制关闭应用，本地通知也会失效（只有远程APNs通知能唤醒应用，本地通知做不到）。

二、一步步排查的调试技巧 #

1. 先确认通知权限状态 #

在应用启动时主动检查权限，并打日志记录，让用户反馈结果：

// 在notifications.ts中添加权限检查逻辑
import firebase from 'react-native-firebase';
import { Platform, Linking } from 'react-native';

export const checkAndRequestNotificationPermission = async () => {
  const hasPermission = await firebase.notifications().hasPermission();
  console.log('[Notification Debug] Permission status:', hasPermission);
  
  if (!hasPermission) {
    const requestResult = await firebase.notifications().requestPermission();
    console.log('[Notification Debug] Permission request result:', requestResult);
    
    // 如果用户拒绝，引导去设置页开启
    if (!requestResult) {
      Platform.OS === 'ios' ? Linking.openURL('app-settings:') : Linking.openSettings();
    }
  }
};

2. 给调度逻辑加详细日志 #

在调用scheduleNotification的地方，把触发时间、通知ID、调度结果都打出来，方便定位是否调度失败：

export const scheduleLocalNotification = async (notificationData) => {
  const notification = new firebase.notifications.Notification()
    .setNotificationId(notificationData.id)
    .setTitle(notificationData.title)
    .setBody(notificationData.body)
    .setData(notificationData.data);

  // 记录触发时间（转成ISO格式方便排查时区问题）
  const triggerDate = new Date(notificationData.triggerTime);
  console.log('[Notification Debug] Scheduling notification ID:', notificationData.id, 'at:', triggerDate.toISOString());

  try {
    await firebase.notifications().scheduleNotification(notification, {
      fireDate: triggerDate.getTime(),
    });
    console.log('[Notification Debug] Notification scheduled successfully');
  } catch (error) {
    console.error('[Notification Debug] Schedule failed:', error.message);
  }
};

3. Android 后台进程排查 #

• 让用户检查应用的「后台活动」权限是否开启，以及是否加入了厂商的「后台白名单」（比如小米的锁屏清理白名单）；
• 用adb logcat过滤应用包名，查看系统是否有杀死进程的日志：

adb logcat | grep com.your-app-package

4. iOS 专注模式排查 #

让用户检查是否开启了专注模式，以及应用是否在专注模式的「允许通知」列表里。

三、针对性的修复方案 #

1. 权限引导优化 #

• 启动时主动请求权限，拒绝后引导用户去设置页开启（上面的调试代码已经包含这个逻辑）；
• 在调度通知前先检查权限，没有权限就提示用户，避免白做调度。

2. 适配系统与依赖升级 #

• Android 8.0+ 必须创建通知渠道：旧版本react-native-firebase可能不会自动创建，手动添加：

// 在应用启动时创建Android通知渠道
if (Platform.OS === 'android') {
  const defaultChannel = new firebase.notifications.Android.Channel(
    'default_notification_channel',
    '默认通知渠道',
    firebase.notifications.Android.Importance.High
  ).setDescription('接收应用所有本地通知');
  
  await firebase.notifications().android.createChannel(defaultChannel);
  // 调度通知时指定渠道
  notification.android.setChannelId('default_notification_channel');
}

• 考虑升级react-native-firebase到兼容RN 0.61.5的6.x版本（官方文档确认过兼容性），新版本修复了很多新系统的适配问题。

3. 调度逻辑优化 #

• 确保触发时间的时区正确：如果后端返回UTC时间，转成用户本地时间再调度；
• 使用唯一通知ID：用UUID或者时间戳生成，避免覆盖旧通知：

// 生成唯一ID的示例
const uniqueNotificationId = `notification-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;

4. 应对Android后台限制 #

• 在应用内添加引导提示，告知用户需要开启后台权限、加入白名单才能正常接收通知；
• 如果厂商后台限制太严，可以考虑用react-native-background-task或者WorkManager来替代部分本地通知调度逻辑，保证后台任务能存活。

5. iOS 强制关闭应用的处理 #

iOS中应用被强制关闭后本地通知无法触发，只能引导用户不要强制关闭应用，或者配合后端用远程APNs通知来补充（但这需要后端支持）。

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