Firestore根集合查询报错求助：根集合查询失败子集合正常

这种情况几乎都是Firestore安全规则导致的，代码写法本身没有问题。

核心原因分析 #

Firestore的安全规则校验逻辑是分层的：

• 查询根集合（如accounts）时，规则会同时校验集合的list权限，以及集合内每一个文档的read权限；
• 查询子集合（如accounts/${accountId}/sites）时，规则仅校验该子集合对应的权限配置。

你看到的错误提示Null value error. for 'list' @ Lxx，说明规则中的某个条件返回了null而非预期的true/false，导致权限校验失败。常见触发场景包括：

• 未登录状态下发起查询，但规则要求request.auth != null；
• 根集合内存在缺少规则依赖字段的文档（比如规则判断resource.data.owner，但某文档无该字段）；
• 规则逻辑存在漏洞，比如直接返回resource.data.uid而非resource.data.uid == request.auth.uid这类明确的布尔判断。

排查步骤 #

• 检查安全规则：打开Firebase控制台的Firestore规则页面，对比根集合（users/accounts）与子集合的权限配置，重点看list和read规则的条件；
• 用规则Playground测试：在规则页面的Playground中模拟根集合的查询请求，精准定位哪一行规则导致了null错误；
• 修正规则逻辑：确保所有权限条件都返回明确的true或false，避免返回null的情况（比如给字段判断加默认值：resource.data.owner ?? '' == request.auth.uid）。

代码验证 #

你的查询代码写法是正确的：

const query = fs.query(fs.collection(firestore, 'accounts'));
const querySnapshot = await getDocs(query);
querySnapshot.forEach((doc) => {
  console.log(doc.id, ' => ', doc.data());
});

与子集合查询的写法一致，排除代码层面的问题。

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