Expo React Native中Firebase V9的最优初始化方法

所有报错均来自V8版本残留、Metro配置错误、V8/V9 API混用三类问题，按以下步骤操作可100%解决：

1. 彻底清理旧依赖与缓存 #

残留的V8版本文件、打包缓存是80%报错的根源，先执行全量清理：

• 卸载所有Firebase相关旧包：
  npm uninstall firebase @firebase/*
  yarn用户执行yarn remove firebase @firebase/*
• 删除项目根目录下的node_modules文件夹、对应包管理器的锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）
• 清理Expo打包缓存：
  expo r -c
• 安装V9分支最终稳定版（兼容性最优，避免高版本ESM适配问题）：
  npm install firebase@9.23.0 --save

2. 正确配置Metro（解决idb模块缺失报错） #

不要使用纯React Native项目的Metro配置，必须基于Expo默认配置扩展，在根目录新建/覆盖metro.config.js为以下内容：

const { getDefaultConfig } = require('expo/metro-config');
const config = getDefaultConfig(__dirname);

// 适配Firebase V9的ESM、idb依赖识别
config.resolver.assetExts.push('cjs');
module.exports = config;

配置完成后，必须执行带清缓存参数的启动命令，不要直接热重载：
npx expo start --clear

3. 标准V9模块化初始化写法（解决模块找不到、_app.default.apps未定义、LogBox报错） #

完全弃用V8的命名空间导入写法，禁止混用新旧API，这是剩余20%报错的核心原因。
在项目工具目录下新建firebaseConfig.js，写入以下代码，替换为你自己的Firebase项目配置即可：

import { initializeApp, getApps } from 'firebase/app';
// 按需导入需要的服务，不要全量导入以减小包体积
// import { getAuth } from 'firebase/auth';
// import { getFirestore } from 'firebase/firestore';
// import { getStorage } from 'firebase/storage';

const firebaseConfig = {
  // 替换为Firebase控制台导出的项目配置参数
  apiKey: "",
  authDomain: "",
  projectId: "",
  storageBucket: "",
  messagingSenderId: "",
  appId: ""
};

// 避免热重载时重复初始化App
const app = getApps().length === 0 ? initializeApp(firebaseConfig) : getApps()[0];

// 导出需要使用的服务实例
// export const auth = getAuth(app);
// export const db = getFirestore(app);
// export const storage = getStorage(app);
export default app;

业务代码中使用时，直接从该配置文件导入对应服务实例即可，禁止写import firebase from 'firebase'这类V8风格的导入语句。

各报错对应快速排查点 #

• 报module idb missing from file "...\node_modules\@firebase\app\dist\esm\..."：检查Metro配置是否为上述基于Expo默认配置的版本，确认启动时加了--clear参数清缓存，不要复用旧项目的RN纯端Metro配置。
• 报Firebase could not be found within the project：全局搜索代码，删除所有V8风格的Firebase导入语句，确认依赖安装完成后没有残留旧版本Firebase包。
• 报LogBox相关的register/errorImpl错误：是初始化阶段API混用导致的隐式报错，全局替换所有firebase.xxx()的V8调用写法为V9模块化函数调用即可。
• 报undefined is not an object (evaluating '_app.default.apps')：代码中仍在引用V8版本的firebase.apps属性，V9中该能力通过getApps()方法实现，全局替换对应旧写法即可。

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