Firestore报错firestore.collection is not a function，学生注册API开发受阻

问题背景 #

使用Firebase开发学生注册API，已完成Firebase初始化，尝试多种方案并查阅相关资料后，仍遇到firestore.collection is not a function错误，且已反复核对初始化配置。

错误原因分析 #

从代码来看，核心问题在于Firestore实例的获取和使用方式错误：

1. 重复导入../db.js，但未确保该文件导出的是正确的Firestore实例
2. 混用了模块化SDK的调用方式，但传入的firestore对象并非有效的Firestore实例

修复步骤 #

1. 修正db.js的初始化代码

确保db.js正确初始化Firebase应用并导出Firestore实例：

const { initializeApp } = require("firebase/app");
const { getFirestore } = require("firebase/firestore");

// 替换为你的Firebase配置
const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "YOUR_AUTH_DOMAIN",
  projectId: "YOUR_PROJECT_ID",
  storageBucket: "YOUR_STORAGE_BUCKET",
  messagingSenderId: "YOUR_SENDER_ID",
  appId: "YOUR_APP_ID"
};

// 初始化应用
const app = initializeApp(firebaseConfig);
// 获取并导出Firestore实例
const db = getFirestore(app);

module.exports = db;

2. 修正学生注册接口代码

调整导入和Firestore方法的使用逻辑：

const { error } = require('console');
const db = require('../db.js'); // 导入正确的Firestore实例
const Student = require('../models/student.js');
const { collection, doc, setDoc } = require("firebase/firestore");

const addStudent = async (req, res, next) => {
    try {
        const data = req.body;
        // 创建集合引用并生成文档ID
        const studentsCollection = collection(db, 'students');
        const newStudentDoc = doc(studentsCollection);
        // 写入数据
        await setDoc(newStudentDoc, data);
        res.send('Record saved successfully');
    } catch (error) {
        res.status(400).send(error.message);
    }
}

关键说明 #

• Firebase v9+采用模块化SDK设计，必须通过getFirestore(app)获取Firestore实例后，才能配合collection、doc等方法使用
• 避免将Firebase应用实例直接当作Firestore实例使用，二者是不同的对象，方法不通用
• 确保项目中Firebase SDK版本统一，不要同时混用模块化和旧版命名空间写法

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