已安装firebase却提示Module not found模块缺失报错如何解决

开发者阿泽

2026-10-5

问题原因

你安装的是Firebase 9.x 版本，该版本采用了全新的模块化API设计，废弃了import firebase from 'firebase'这种旧版全局导入语法，这是第一次报错的核心原因。
你后续修改的import firebase from '/firebase'写法也是错误的：以/开头的导入路径会指向项目根目录，你项目根目录下不存在对应的firebase文件，因此会触发「相对导入超出src目录」的报错。

解决方案

方案1：使用新版模块化写法（官方推荐）

删除现有错误导入语句，按你需要使用的功能按需导入即可，示例代码如下：

// 导入Firebase基础初始化方法
import { initializeApp } from "firebase/app";
// 按需导入所需服务，示例为认证、云数据库服务
import { getAuth } from "firebase/auth";
import { getFirestore } from "firebase/firestore";

// 填入你自己的Firebase项目配置（从Firebase控制台获取）
const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_AUTH_DOMAIN",
  projectId: "YOUR_PROJECT_ID",
  storageBucket: "YOUR_STORAGE_BUCKET",
  messagingSenderId: "YOUR_MESSAGING_SENDER_ID",
  appId: "YOUR_APP_ID"
};

// 初始化Firebase实例
const app = initializeApp(firebaseConfig);
// 初始化对应服务，后续直接调用对应实例即可
const auth = getAuth(app);
const db = getFirestore(app);

方案2：兼容旧版代码写法

如果你的项目有大量旧版Firebase代码不想重构，可以使用兼容包导入，写法如下：

// 导入兼容版全局实例
import firebase from 'firebase/compat/app';
// 按需导入对应服务的兼容包
import 'firebase/compat/auth';
import 'firebase/compat/firestore';

// 后续代码可以沿用旧版firebase.xxx的调用方式
const app = firebase.initializeApp({ /* 你的配置 */ });
const auth = firebase.auth();

异常排查

如果修改导入语法后仍报错，按以下步骤操作：