Firebase Firestore addDoc调用报错：collection()参数类型不符合要求

API 探路者

2026-7-23

问题分析与解决

报错Uncaught (in promise) FirebaseError: Expected first argument to collection() to be a CollectionReference, a DocumentReference or FirebaseFirestore的核心原因是初始化数据库实例时用错了方法：

你导入了Firestore的getFirestore方法，但代码里却调用了getDatabase()——这个方法属于Firebase实时数据库，并非Firestore专用，导致传入collection()的db不是合法的Firestore实例，进而触发错误。

修正后的代码

只需把getDatabase()替换成导入的getFirestore()即可，同时要确保已完成Firebase应用的初始化（通过initializeApp配置项目信息）。

完整修正示例

// 导入Firebase应用初始化方法
import { initializeApp } from "https://www.gstatic.com/firebasejs/9.19.1/firebase-app.js";
import {
  getFirestore, collection, addDoc
}from "https://www.gstatic.com/firebasejs/9.19.1/firebase-firestore.js";

// 从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);
// 初始化Firestore实例
const db = getFirestore(app);

async function addq(){
  try {
    const docRef = await addDoc(collection(db, "QD"), {
      Room: 2,
      Time: "3:30",
      State: "CPT",
    });
    console.log("文档添加成功，ID: ", docRef.id);
  } catch (e) {
    console.error("添加文档失败: ", e);
  }
}