本文档旨在解决在使用 Firebase (compat) 库初始化 Firestore 时遇到的 “TypeError: getFirestore is not a function” 错误。我们将探讨问题的原因，并提供使用 Firebase Modular SDK 正确初始化 Firestore 的方法，同时确保所有依赖项都已正确安装和更新，以便开发者能够顺利地在 Next.JS 项目中使用 Firebase 服务。
问题分析
该错误通常发生在尝试使用 Firebase (compat) 库中的 getFirestore 函数时，但该函数未正确导入或 Firebase 应用未正确初始化。这可能是由于以下几个原因：
- 使用了 Firebase (compat) 库，但没有正确配置。
- Firebase 依赖版本过旧，导致函数不可用。
- 导入路径错误，导致 getFirestore 函数无法找到。
解决方案：使用 Firebase Modular SDK
Firebase 官方推荐使用 Modular SDK，因为它体积更小、性能更好，并且更易于维护。以下是使用 Modular SDK 初始化 Firebase 和 Firestore 的步骤：
1. 安装 Firebase 依赖：
首先，确保已安装 Firebase 依赖。如果尚未安装，请使用以下命令安装：
npm install firebase
如果已经安装，为了确保使用的是最新版本，请更新 Firebase 依赖：
npm install firebase@latest
2. 初始化 Firebase 应用和 Firestore:
在你的代码中，使用以下代码初始化 Firebase 应用和 Firestore：
import { initializeApp } from "firebase/app"; import { getFirestore } from "firebase/firestore"; import { getAuth } from "firebase/auth"; const firebaseConfig = { apiKey: process.env.NEXT_PUBLIC_FIREBASE_API_KEY, authDomain: process.env.NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN, projectId: process.env.NEXT_PUBLIC_FIREBASE_PROJECT_ID, storageBucket: process.env.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET, messagingSenderId: process.env.NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID, appId: process.env.NEXT_PUBLIC_FIREBASE_APP_ID, measurementId: process.env.NEXT_PUBLIC_FIREBASE_MEASUREMENT_ID, }; // Initialize Firebase const app = initializeApp(firebaseConfig); export const DB = getFirestore(app); export const auth = getAuth(app);
代码解释：
- import { initializeApp } from “firebase/app”;：从 firebase/app 模块导入 initializeApp 函数，用于初始化 Firebase 应用。
- import { getFirestore } from “firebase/firestore”;：从 firebase/firestore 模块导入 getFirestore 函数，用于获取 Firestore 实例。
- import { getAuth } from “firebase/auth”;：从 firebase/auth 模块导入 getAuth 函数，用于获取 Authentication 实例。
- firebaseConfig：包含你的 Firebase 项目配置信息。请确保所有配置项都已正确设置。
- const app = initializeApp(firebaseConfig);：使用配置信息初始化 Firebase 应用。
- export const DB = getFirestore(app);：获取 Firestore 实例并将其导出，以便在其他模块中使用。
- export const auth = getAuth(app);：获取 Authentication 实例并将其导出，以便在其他模块中使用。
3. 注意事项：
- 确保 firebaseConfig 对象中的所有配置项都已正确设置。这些配置项可以在 Firebase 控制台中找到。
- 如果你的项目已经使用了 Firebase (compat) 库，建议逐步迁移到 Modular SDK。
- 在使用 Firebase 服务之前，务必先初始化 Firebase 应用。
总结
通过使用 Firebase Modular SDK 并按照上述步骤操作，你应该能够成功初始化 Firebase 和 Firestore，并解决 “TypeError: getFirestore is not a function” 错误。请确保你的 Firebase 依赖已更新到最新版本，并且配置信息正确无误。 如果问题仍然存在，请检查你的代码中是否存在其他错误，或者查阅 Firebase 官方文档以获取更多帮助。
