Firestore含文档集合返回空数组问题排查

我的Firestore数据结构如下：

{
  "data": {
    "yCzd0CGyoS0L05vXIy8J": {
      "prop1": true,
      "collection1": {
        "5vXIy8JyCzd0CGyoS0L0": {
          "prop1": true
        },
        "XIy8JyCzd0CGyoS0L05v": {
          "prop1": true
        },
        "vXIy8JyCzd0CGyoS0L05": {
          "prop1": true
        }
      }
    },
    "zd0CGyoS0L05vXIy8JyC": {
      "prop1": true,
      "collection1": {}
    },
    "yoS0L05vXIy8JyCzd0CG": {
      "prop1": false,
      "collection1": {}
    }
  }
}

我需要获取data集合中所有文档的ID，在Node.js中使用以下代码：

const data = await firestore.collection("data").get();
console.log(data.docs);

但即使集合中存在文档，该语句仍返回空数组。不过单独查询某个特定文档时能得到正确结果：

const data = await firestore.collection("data").doc("zd0CGyoS0L05vXIy8JyC").get();
console.log(data.data());

同时在Firestore控制台的"Query builder"中，路径设为/data时显示"No query result"。我在另一个Firebase项目中使用相同结构却能正常工作，请问是什么原因导致这种差异？

• 安全规则限制（最可能的原因）
  单文档查询成功说明你拥有单个文档的read权限，但集合列表查询需要明确的list权限。如果当前项目的安全规则仅允许读取特定ID的文档（例如allow read: if resource.id == request.auth.uid;），集合级别的查询会被拦截，返回空数组。
  解决方法：调整安全规则，确保允许对data集合进行列表查询，示例规则如下：

  rules_version = '2';
  service cloud.firestore {
    match /databases/{database}/documents {
      match /data/{docId} {
        allow read: if true; // 根据实际需求替换为合适的权限验证逻辑
      }
    }
  }
  

• 误将集合当作嵌套文档创建
  确认Firestore控制台中data是集合而非单个文档。如果手动添加数据时误将data创建为一个文档，里面嵌套子对象，那么firestore.collection("data")指向的是不存在的集合，自然查询不到结果。不过你能成功查询单个文档，这个可能性较低，仍可检查控制台的层级结构确认。

• 数据同步或缓存问题
  极少数情况下，本地缓存或服务器同步延迟可能导致查询结果异常。可以尝试强制从服务器获取数据，跳过本地缓存：

  const data = await firestore.collection("data").get({ source: 'server' });
  console.log(data.docs);
  

  同时可重启Node.js服务，确保客户端与Firestore服务器连接正常。

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