React Native集成@react-native-firebase/messaging找不到FirebaseInstanceId如何解决

云原生阿岚

2026-10-20

错误根因

你手动覆盖使用的Firebase BOM 28.0.1版本已经完全移除了废弃的FirebaseInstanceId类，但你当前使用的@react-native-firebase/messaging@11.5.0版本的原生代码仍然依赖这个类，二者版本不兼容直接导致编译失败。你之前使用默认26.8.0版本启动崩溃属于缺少通知通道的配置问题，按以下步骤修复即可：

修复步骤

1. 回退Firebase BOM版本

删除你在android/build.gradle或android/app/build.gradle中手动添加的Firebase BOM 28.0.1强制覆盖配置，恢复@react-native-firebase包默认的BOM版本绑定。

2. 修复默认BOM版本的启动崩溃问题

无日志启动崩溃是因为Android 8.0+要求应用必须配置通知通道才能展示FCM推送，按以下要求补充配置：

在android/app/src/main/AndroidManifest.xml的<application>标签内添加如下元数据：

<meta-data
  android:name="com.google.firebase.messaging.default_notification_channel_id"
  android:value="fcm_default_channel" />

在App初始化逻辑中添加通知通道创建代码：

import { Platform } from 'react-native';
import messaging from '@react-native-firebase/messaging';

// 应用启动时执行
if (Platform.OS === 'android') {
  await messaging().createChannel({
    id: 'fcm_default_channel',
    name: '推送通知',
    importance: messaging.NotificationAndroidImportance.HIGH
  });
}