React Native安卓项目集成Firebase Messaging编译报错求助

关键说明 #

@react-native-firebase/messaging 安装后会自动关联Gradle依赖，不需要手动添加，但必须完成安卓端的基础配置，这几乎是编译失败的核心原因。

分步排查修复 #

• 确认Firebase配置文件与Gradle插件

  1. 把Firebase控制台下载的google-services.json放到android/app/目录，包名必须和项目一致。
  2. 检查android/build.gradle的buildscript依赖里有没有Google服务插件：

     buildscript {
       dependencies {
         classpath 'com.google.gms:google-services:4.3.15' // 版本可适配你的项目
       }
     }
     

  3. 确认android/app/build.gradle末尾有这行：

     apply plugin: 'com.google.gms.google-services'
     

• 检查版本兼容性
  你的RNFB依赖版本统一（16.5.0）没问题，但要确保：

  • React Native版本是0.68及以上（16.x RNFB适配这个区间），版本不匹配就升级RN或降级RNFB。
  • 安卓项目的compileSdkVersion和targetSdkVersion设为33+，RNFB 16.x需要这个版本支持。

• 清理缓存重建
  执行以下命令彻底清理缓存后重新编译：

  cd android && ./gradlew clean
  cd .. && npx react-native start --reset-cache
  npx react-native run-android
  

• 补充Manifest配置
  在android/app/src/main/AndroidManifest.xml里添加必要的权限和服务：

  <!-- 推送基础权限 -->
  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  <uses-permission android:name="android.permission.WAKE_LOCK" />
  
  <!-- Firebase Messaging服务声明 -->
  <service
      android:name="com.google.firebase.messaging.FirebaseMessagingService"
      android:exported="false">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

• 查看详细错误日志
  如果以上步骤没解决，运行./gradlew assembleDebug --stacktrace获取完整编译日志，日志里会明确指出错误根源（比如依赖冲突、缺失类、配置语法错误等），再针对性修复即可。

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