如何在谷歌云函数中使用Where查询读取Firestore文档及故障排查

架构老林

2026-10-3

问题原因

你代码的核心错误是混淆了单文档查询和条件查询的返回值类型：

直接通过文档ID查询（doc(文档ID).get()）返回的是单个DocumentSnapshot对象，可以直接用.exists判断是否存在
调用where()的条件查询返回的是QuerySnapshot对象，哪怕匹配结果只有一个，也需要先从该对象的docs数组中提取文档，不能直接判断.exists

修复后的代码

return await firestore.collection(COLLECTION_NAME).where('APIKEY', '==', '<APIKEY_VALUE>').get().then(querySnapshot => {            
  // 先判断有没有匹配的文档
  if (querySnapshot.empty) {
    return res.status(404).send({
      error: 'Unable to find the document'
    });
  }
  // 取第一个匹配的文档（如果你的业务逻辑是APIKEY唯一的话）
  const doc = querySnapshot.docs[0];
  const data = doc.data();
  console.log(data);
  if (!data) {
    return res.status(404).send({
      error: 'Found document is empty'
    });
  }
  return res.status(200).send(data);
}).catch(err => {
  console.error(err);
  return res.status(404).send({
    error: 'Unable to retrieve the document',
    err
  });
});