You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

无法接收Firebase Cloud Message,React Native项目构建失败求助

解决React Native Firebase Starter构建时的Multidex错误(FCM相关)

看起来你遇到的是Multidex相关的构建报错,这在React Native集成Firebase时挺常见的,核心原因是项目依赖的方法总数超过了Android默认的65536上限。我给你整理了几个实用的解决步骤:

1. 开启Multidex支持

首先得在Android项目配置里明确开启Multidex:

  • 打开android/app/build.gradle文件,找到defaultConfig代码块,添加multiDexEnabled true:
    defaultConfig {
        applicationId "com.yourprojectname"
        minSdkVersion rootProject.ext.minSdkVersion
        targetSdkVersion rootProject.ext.targetSdkVersion
        versionCode 1
        versionName "1.0"
        multiDexEnabled true // 新增这一行
    }
    
  • 接着在同一个文件的dependencies块里添加Multidex依赖:
    dependencies {
        // 保留你已有的其他依赖
        implementation 'androidx.multidex:multidex:2.0.1'
    }
    
  • 如果你的项目没有自定义Application类,修改android/app/src/main/AndroidManifest.xml里的<application>标签,指定使用MultiDexApplication:
    <application
        android:name="androidx.multidex.MultiDexApplication"
        android:label="@string/app_name"
        android:icon="@mipmap/ic_launcher"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:allowBackup="false"
        android:theme="@style/AppTheme">
        <!-- 其他原有内容 -->
    </application>
    

2. 清理构建缓存

旧的构建缓存经常会引发奇怪的报错,执行以下命令清理后重新构建:

cd android
./gradlew clean
cd ..
react-native run-android

3. 检查依赖版本冲突

Firebase和Google Play Services的依赖版本不匹配也可能触发这个问题:

  • 查看项目的依赖树,找出冲突的依赖项:

cd android
./gradlew app:dependencies

- 在`android/build.gradle`的`buildscript`块里统一Firebase和Google服务的版本,比如:
```gradle
buildscript {
    ext {
        buildToolsVersion = "30.0.2"
        minSdkVersion = 21
        compileSdkVersion = 30
        targetSdkVersion = 30
        firebaseVersion = "29.0.0" // 使用兼容的最新稳定版本
    }
    // 其他原有配置
}

4. 再次确认google-services.json的位置

确保你把对应Firebase项目的google-services.json准确放在了android/app/目录下,不要放到子目录或者其他位置。

如果以上步骤都试过还是不行,建议检查你的React Native版本和react-native-firebase的版本兼容性——有时候starter模板的版本可能和你本地的RN版本不匹配,需要升级或降级对应的依赖包。

内容的提问来源于stack exchange,提问作者Sachin Gupta

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.27 04:08:38