Cloud Firestore文档返回问题：Node.js无法获取手动录入文档

嘿，这个坑我刚学Firestore的时候也踩过！你现在拿到的docs其实是QuerySnapshot对象，不是直接的文档数据数组——这就是为什么你能看到_size是2，但找不到具体内容的原因。

问题原因 #

Firestore的collection.get()返回的QuerySnapshot是一个包装对象，它包含了查询到的文档集合，但这些文档的实际数据并不是直接暴露在对象的顶层属性里，而是需要通过每个文档的data()方法来提取。直接把整个QuerySnapshot序列化返回的话，只会显示它的内部元数据（比如_size），不会包含你要的文档内容。

修复后的代码示例 #

你需要遍历这个QuerySnapshot，逐个提取文档的数据（还可以顺便带上文档ID，很多场景下都会用到）：

db.collection('categories').get()
  .then((querySnapshot) => {
    // 创建一个空数组来存储处理后的文档数据
    const categoryList = [];
    // 遍历每个文档快照
    querySnapshot.forEach((doc) => {
      // 合并文档ID和数据，方便后续使用
      categoryList.push({
        id: doc.id,
        ...doc.data()
      });
    });
    // 返回处理后的数组
    res.json(categoryList);
  })
  .catch((error) => {
    // 别忘了添加错误处理，调试的时候更省心
    res.status(500).json({ error: '获取分类数据失败：' + error.message });
  });

额外小提示 #

• 如果是获取单个文档（比如db.collection('categories').doc('xxx').get()），返回的是DocumentSnapshot，同样需要用doc.data()来提取数据，比如doc.data() || {}可以避免文档不存在时返回null的问题。
• QuerySnapshot还有docs属性，是一个DocumentSnapshot数组，你也可以用map来简化遍历：

  const categoryList = querySnapshot.docs.map(doc => ({
    id: doc.id,
    ...doc.data()
  }));
  

内容的提问来源于stack exchange，提问作者Michał Sadowski