React Native应用webpack实现时调用firebase.app()触发Android端Firebase模块未安装报错

这个报错本质是JS层调用firebase.app()时，找不到对应的Android原生Firebase模块实现。你使用的React Native Firebase库核心原生部分没有被正确集成到Android项目中，导致原生桥接失败。

1. 依赖安装校验 #

• 执行命令检查核心依赖是否安装：

  npm list @react-native-firebase/app
  # 或yarn环境执行
  yarn list @react-native-firebase/app
  

  无对应版本输出的话，先执行安装命令：

  npm install @react-native-firebase/app
  # 或yarn环境执行
  yarn add @react-native-firebase/app
  

2. 原生集成配置校验 #

手动集成场景（RN 0.59及以下、关闭自动链接的RN 0.60+项目） #

• 打开android/app/src/main/java/[你的项目包名路径]/MainApplication.java文件：
  • 确认顶部存在导入语句：import io.invertase.firebase.app.ReactNativeFirebaseAppPackage;
  • 确认getPackages()方法返回的包列表中存在new ReactNativeFirebaseAppPackage()代码行

自动集成场景（RN 0.60+默认开启自动链接） #

• 检查android/settings.gradle文件是否自动生成了如下配置：

  include ':react-native-firebase_app'
  project(':react-native-firebase_app').projectDir = new File(rootProject.projectDir, '../node_modules/@react-native-firebase/app/android')
  

• 检查android/app/build.gradle的dependencies块是否自动包含：implementation project(':react-native-firebase_app')

3. 项目级配置校验 #

• 检查android/build.gradle的allprojects > repositories块，确认存在以下仓库配置：

  google()
  maven { url "https://www.jitpack.io" }
  

• 检查android/app/build.gradle文件末尾，确认存在插件引入：apply plugin: 'com.google.gms.google-services'
• 确认从Firebase控制台下载的google-services.json文件已经放到android/app/目录下，文件内容完整无修改错误

4. 缓存清理重试 #

所有配置确认无误后，按以下步骤清理缓存重新构建：

• 关闭当前运行的Metro服务
• 进入Android目录执行清理命令：cd android && ./gradlew clean
• 可选操作：删除项目根目录的node_modules文件夹、package-lock.json/yarn.lock文件重新安装依赖，删除android/.gradle目录
• 回到根目录重新执行构建命令：npx react-native run-android

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