Firebase使用报错：'getDoc'未从'firebase/firestore'导出 升级9.21.0后无法使用

报错'getDoc' is not exported from 'firebase/firestore'的原因 #

• getDoc是Firebase 9及以上版本才提供的模块化API，Firebase 8.x版本使用的是命名空间式API，没有这个导出项，你最初在v8环境调用v9专属API自然会触发该报错。

升级到v9.21.0后无法使用的修复方案 #

根据你的代码兼容需求二选一即可：

方案1：使用新版模块化API（推荐，支持树形摇减小打包体积） #

先调整firebase.js配置为正确的模块化写法：

import { initializeApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";

// 替换为你自己的Firebase项目配置
const firebaseConfig = {
  apiKey: "你的项目apiKey",
  authDomain: "你的项目authDomain",
  projectId: "你的项目projectId",
  storageBucket: "你的项目storageBucket",
  messagingSenderId: "你的项目messagingSenderId",
  appId: "你的项目appId"
};

const app = initializeApp(firebaseConfig);
export const db = getFirestore(app);

调用getDoc的正确示例：

import { getDoc, doc } from "firebase/firestore";
import { db } from "./firebase"; // 替换为你的firebase.js实际路径

async function getSingleDoc(collectionName, docId) {
  const docRef = doc(db, collectionName, docId);
  const docSnapshot = await getDoc(docRef);
  if (docSnapshot.exists()) {
    return docSnapshot.data();
  }
  return null;
}

方案2：兼容旧版v8写法，无需修改原有业务代码 #

使用兼容包版本的Firebase依赖，调整firebase.js配置如下：

import firebase from "firebase/compat/app";
import "firebase/compat/firestore";

// 替换为你自己的Firebase项目配置
const firebaseConfig = {
  apiKey: "你的项目apiKey",
  authDomain: "你的项目authDomain",
  projectId: "你的项目projectId",
  storageBucket: "你的项目storageBucket",
  messagingSenderId: "你的项目messagingSenderId",
  appId: "你的项目appId"
};

firebase.initializeApp(firebaseConfig);
export const db = firebase.firestore();

该模式下原有v8版本的db.collection("集合名").doc("文档id").get()写法可以正常运行，也可混写新版模块化API。

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