Firebase调用getDocs获取Firestore集合数据控制台返回空数组问题

API 探路者

2026-8-29

问题描述

我是Firebase初学者，尝试将Firestore集合数据打印到控制台，实现代码如下：

// Import the functions you need from the SDKs you need
import * as firebase from "firebase/app";
import { initializeApp } from "firebase/app";
import {getFirestore, collection, getDocs} from "firebase/firestore"


const firebaseConfig = {
  apiKey: "AIzaSyA1zo9ci0RXQYBxxxxxxxxx",
  authDomain: "xxxxx.firebaseapp.com",
  databaseURL: "https://xxxxxx-default-rtdb.firebaseio.com",
  projectId: "xxxxxx",
  storageBucket: "xxxxx.appspot.com",
  messagingSenderId: "380xxxxx",
  appId: "1:38065xxxxxx:web:5f49bf6dxxxxxxx5",
  //measurementId: "G-TYX10C1CBE"
};

// Initialize Firebase
initializeApp(firebaseConfig)


//init services
const db = getFirestore();

//collection ref
const colRef = collection(db, 'Achievements')

//get collection data
getDocs(colRef)
  .then((snapshot) => {
    console.log(snapshot.docs)
  })

Firestore集合参考截图：
Firestore Collection

上述代码执行后控制台仅返回Array []空数组，无法定位问题原因。

为排查权限问题，我已将Firestore安全规则修改为全开放读写（规则配置如下，明确标注生产环境不可使用该配置）：

// Allow read/write access to all users under any conditions
// Warning: **NEVER** use this rule set in production; it allows
// anyone to overwrite your entire database.
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read, write: if true;
    }
  }
}

修改安全规则后仍无法正常获取Achievements集合数据，需要问题排查指引。

排查方案

按优先级逐一核对以下常见问题，基本可以定位根因：

首先核对集合名匹配度：Firestore的集合名、文档名严格区分大小写，逐字确认控制台集合名和代码中传入的'Achievements'完全一致，包括首字母大小写、是否存在前后多余空格。如果名称不匹配，接口不会抛出权限类错误，只会直接返回空数组，这是新手最高发的踩坑点。
核对项目关联正确性：检查firebaseConfig中的projectId字段，确认和你创建Achievements集合所在的Firebase项目ID完全匹配，初始化时连错其他项目会直接导致读取不到目标数据。
补充错误捕获逻辑：现有代码只实现了请求成功的回调，没有异常捕获分支，将读取数据的代码修改为如下形式，控制台会打印明确的错误信息，无需盲目排查：

getDocs(colRef)
  .then((snapshot) => {
    console.log('本次读取到的文档总数：', snapshot.size)
    snapshot.docs.forEach(doc => console.log(doc.id, doc.data()))
  })
  .catch(err => {
    console.error('Firestore读取失败：', err)
  })

确认数据库服务类型：Firebase提供两款完全独立的数据库产品，分别是实时数据库（Realtime Database）和Cloud Firestore，二者API不通用。如果你是在实时数据库板块创建的数据集，使用Firestore的API无法读取到对应内容，需要在控制台左侧菜单切换到Cloud Firestore板块，确认Achievements集合确实存在于该服务下。
清理冗余导入语句：代码首行import * as firebase from "firebase/app"是Firebase v8及更早版本的命名空间式导入写法，和后续v9版本的模块化导入import { initializeApp } from "firebase/app"混用，很容易引发SDK初始化异常，直接删除这行旧版导入语句即可。
确认安全规则生效：修改安全规则后服务端需要1-2分钟的同步时间，规则未生效前请求会沿用旧权限逻辑。可以直接在Firestore控制台的规则模拟器中，模拟对Achievements集合的读请求，确认规则配置确实放通了对应权限。

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