解决 Firebase 初始化错误：TypeError: getFirestore is not a function

本文档旨在解决在使用 Firebase (compat) 库初始化 Firestore 时遇到的 "TypeError: getFirestore is not a function" 错误。我们将探讨问题的原因，并提供使用 Firebase Modular SDK 正确初始化 Firestore 的方法，同时确保所有依赖项都已正确安装和更新，以便开发者能够顺利地在 Next.js 项目中使用 Firebase 服务。

问题分析

该错误通常发生在尝试使用 Firebase (compat) 库中的 getFirestore 函数时，但该函数未正确导入或 Firebase 应用未正确初始化。这可能是由于以下几个原因：

1. 使用了 Firebase (compat) 库，但没有正确配置。
2. Firebase 依赖版本过旧，导致函数不可用。
3. 导入路径错误，导致 getFirestore 函数无法找到。

解决方案：使用 Firebase Modular SDK

Firebase 官方推荐使用 Modular SDK，因为它体积更小、性能更好，并且更易于维护。以下是使用 Modular SDK 初始化 Firebase 和 Firestore 的步骤：

1. 安装 Firebase 依赖：

首先，确保已安装 Firebase 依赖。如果尚未安装，请使用以下命令安装：

npm install firebase

如果已经安装，为了确保使用的是最新版本，请更新 Firebase 依赖：

闪念贝壳

闪念贝壳是一款AI 驱动的智能语音笔记，随时随地用语音记录你的每一个想法。

下载

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 官方文档以获取更多帮助。