React Native/Expo集成Firebase后应用崩溃或无法加载求助

必做排查步骤 #

• 严格匹配Expo SDK与Firebase版本
  Expo和Firebase版本绑定非常严格，手动指定版本大概率出问题。直接用Expo官方命令安装兼容版本：
  npx expo install firebase
  要是已经装过旧版本，先执行npm uninstall firebase卸载，再跑上面的命令。
  若需手动指定版本，参考官方对应关系（比如SDK 49对应firebase@10.1.0，SDK 50对应10.7.0+），别盲目试版本。

• 检查Firebase配置正确性
  确保初始化代码用的是Expo专用配置（从Firebase控制台「添加应用」→「Web应用」复制，别选原生iOS/Android选项），格式示例：

  import { initializeApp } from 'firebase/app';
  const firebaseConfig = {
    apiKey: "你的API_KEY",
    authDomain: "你的AUTH_DOMAIN",
    projectId: "你的PROJECT_ID",
    storageBucket: "你的STORAGE_BUCKET",
    messagingSenderId: "你的SENDER_ID",
    appId: "你的APP_ID"
  };
  const app = initializeApp(firebaseConfig);
  

  缺字段或写错值会直接导致加载失败。

• 彻底清除缓存重启
  缓存是常见诱因，执行以下命令：

  • 清空Expo缓存：npx expo start --clear
  • 清空npm缓存：npm cache clean --force（用yarn则执行yarn cache clean）
  • 关闭所有Expo相关进程，重新启动项目

• 移除冲突依赖
  Expo项目不需要安装@react-native-firebase/*这类原生包，检查package.json，删掉所有带该前缀的依赖，再重装firebase。

• 隔离测试初始化代码
  暂时注释掉所有Firebase功能代码（比如Auth、Firestore调用），只保留初始化逻辑。如果项目能正常加载，再逐步加回功能模块，排查是哪部分导致的崩溃。

特殊场景处理 #

• iOS模拟器崩溃：检查模拟器系统版本（至少iOS 13），确保网络正常，或直接重启模拟器。
• Android设备/模拟器：确认app.json的android.permissions里包含"INTERNET"，检查设备网络连接状态。

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