React Native集成Firebase通知无接收问题排查求助

你遇到的问题我之前也碰到过，结合你的代码和使用的依赖版本，咱们一步步拆解可能的原因：

一、版本兼容性的潜在问题 #

你用的react-native-firebase@5.5.6确实是比较老旧的版本（现在最新稳定版已经到v17了），这个版本存在几个可能影响iOS通知的问题：

• 对iOS 13+的APNs适配不完善，Apple后续更新了推送协议，老版本SDK可能存在兼容性问题，导致通知无法正常送达；
• 部分已知的监听注册bug，比如冷启动时无法捕获getInitialNotification的情况；
• 与新版本React Native的API兼容性问题，可能导致权限请求或Token获取流程异常。

如果后续排查配置和代码后仍无法解决，升级到较新的稳定版本（比如v10+，注意匹配你的React Native版本）会是一个有效的解决方案，但升级时需要留意v6+版本的API迁移文档——因为从v6开始，react-native-firebase的API结构有较大变化。

二、初始化位置的隐患 #

你把通知监听的初始化放在Navigator组件的componentDidMount里，这里可能存在两个问题：

1. 冷启动时错过通知：当App从完全关闭的状态被通知唤醒时，Navigator的componentDidMount执行时机可能偏晚，导致getInitialNotification无法及时捕获到启动通知；
2. 监听注册不及时：如果导航栈的初始页面加载有延迟，监听可能无法在App启动早期完成注册，导致前台/后台通知无法被捕获。

建议把通知监听的初始化逻辑移到App的根组件（比如App.js）的componentDidMount中，确保App启动时第一时间完成监听注册。

三、代码中的细节调整点 #

看你的FirebaseService.js和Navigator.js，有几个需要优化的地方：

1. 遗漏messageListener的注销：在Navigator的componentWillUnmount中，你只注销了notificationListener和notificationOpenedListener，但没有处理messageListener，这可能导致内存泄漏或监听重复注册，建议补充：

componentWillUnmount() {
  FirebaseService.notificationListener();
  FirebaseService.notificationOpenedListener();
  FirebaseService.messageListener(); // 新增这一行
}

2. getInitialNotification的执行时机：当前你在createNotificationListeners中用await获取初始通知，但如果这个方法执行太晚，就会错过冷启动的通知触发。建议把这部分逻辑单独抽出来，在App启动时立即执行。
3. 前台通知的可见性：iOS中，App在前台时默认不会弹出通知弹窗，你的代码里只做了console.log，所以测试前台通知时，需要通过Xcode控制台查看日志，或者手动构建本地通知弹窗：

// 在onNotification回调中添加本地通知展示
const localNotification = new Firebase.notifications.Notification()
  .setNotificationId(notification.notificationId)
  .setTitle(title)
  .setBody(body)
  .setSound('default');

Firebase.notifications().displayNotification(localNotification);

四、iOS必备配置检查 #

除了代码，iOS端的原生配置也很关键：

• Info.plist配置：确保添加了后台推送权限，在Info.plist中添加：

<key>UIBackgroundModes</key>
<array>
  <string>remote-notification</string>
</array>

• APNs密钥配置：确认Firebase控制台中iOS应用的APNs密钥（.p8文件）是正确的，密钥绑定的Bundle ID和你的App完全一致，并且密钥的权限包含推送服务；
• 测试场景：测试后台通知时，确保App处于后台或完全关闭状态——前台通知默认不会弹窗，只能通过日志查看。

五、测试Payload的正确性 #

在Firebase控制台发送测试通知时，确保Payload包含notification字段，示例如下：

{
  "notification": {
    "title": "测试通知",
    "body": "这是一条测试推送"
  },
  "to": "你的FCM Token"
}

如果只发送data字段的Payload，iOS后台可能无法触发通知展示，需要配合content-available: 1字段，同时代码中需要处理onMessage回调。

内容的提问来源于stack exchange，提问作者Peter G.