如何通过自定义ID在Firestore中查询文档？查询失败排查

核心问题1：查询代码逻辑错误 #

你调用store.collection("products").doc(id).get()后得到的是单个文档快照（DocumentSnapshot），而非查询快照（QuerySnapshot），因此不存在docs属性，map操作自然无法得到数据。

修正后的查询代码 #

const {id} = data;
const store = admin.firestore();

// 获取单个文档快照
const docSnapshot = await store.collection("products").doc(id).get();

let product = null;
// 先判断文档是否存在
if (docSnapshot.exists) {
  product = {
    ...docSnapshot.data(),
    id: docSnapshot.id
  };
}

核心问题2：导入与查询的集合不匹配 #

确认导入数据时使用的collectionName变量值为"products"——如果导入时集合名称和查询的"products"不一致，数据会存在其他集合里，控制台和查询自然找不到结果。

导入代码的校验与优化 #

可以添加错误捕获，确认数据是否成功导入：

return Promise.all(items.map(item => {
    const { id, ...data } = item;
    return db.collection(collectionName)
      .doc(id)
      .set(data);
})).catch(err => {
    console.error("数据导入失败：", err);
    throw err;
});

额外校验点 #

• 确认Firestore控制台选择的是正确的项目和环境（避免误看测试/生产项目）；
• 确认查询时传入的id与导入时的id完全一致（比如都是字符串'1081'，而非数字1081）；
• 检查导入的数据类型是否符合Firestore要求：你的数据里price（数字）、rating（数字）、其他字段（字符串）都符合要求，这部分没问题。

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