React Native Android首次接入Firebase提示apiKey缺失或无效如何解决？

DevOps 小满

2026-10-6

React Native 接入Firebase报apiKey缺失或无效的解决方案

核心排查修复步骤

检查google-services.json放置路径是否正确：必须放在安卓项目的android/app/根目录下，打开配置文件确认api_key字段下的current_key不为空，若为空需登录Firebase控制台重新生成Web API Key后重新下载配置文件。
补全gradle插件配置：仅在项目级build.gradle添加google-services依赖不生效，需要在应用级android/app/build.gradle文件的最末尾追加一行配置：
```
apply plugin: 'com.google.gms.google-services'
```

调整初始化逻辑：自动解析配置失败时可以手动传入Firebase配置项初始化，避免依赖自动解析，同时增加实例判断避免重复初始化报错，示例代码：

import Firebase from '@react-native-firebase/app'
useEffect(()=>{
  // 配置参数可从Firebase控制台项目设置页复制获取
  const firebaseConfig = {
    apiKey: "你的项目apiKey",
    authDomain: "你的项目id.firebaseapp.com",
    projectId: "你的项目id",
    storageBucket: "你的项目id.appspot.com",
    messagingSenderId: "发件人id",
    appId: "你的应用id"
  };
  if(!Firebase.apps.length) {
    Firebase.initializeApp(firebaseConfig)
  }
},[])

验证版本兼容性：你当前使用的Android Gradle插件版本为4.1.0，@react-native-firebase/app依赖版本不要高于14.9.0，15.x及以上版本要求Gradle插件最低7.0+，版本不匹配会导致配置解析失败。
全链路清理缓存重试：
- 执行cd android && ./gradlew clean清理安卓构建缓存
- 执行npx react-native start --reset-cache启动Metro并清空打包缓存
- 卸载测试设备上已安装的旧版应用后重新执行npx react-native run-android安装
若同时编译iOS版本，需确认已将GoogleService-Info.plist通过Xcode导入到iOS项目主目录下，仅拖拽到文件夹不会生效。