Firestore报错：期望DocumentReference却传入Query对象求解决

错误原因 #

你调用getDoc()时传入的是通过query()创建的集合查询对象（Query），但getDoc()仅支持接收单个文档的引用（DocumentReference），这就是报错的核心原因。

解决方案1：用getDocs()处理查询结果 #

如果你的vendors集合中文档ID和商家UID不绑定，必须通过vendor_id字段匹配查询，就需要用getDocs()获取查询快照，再提取目标文档：

const shopNameElement = document.querySelector('.shop_name')
  
onAuthStateChanged(auth, (user) => {
  if (user) {
    const uid = user.uid;
    const userQuery = query(vendorRef, where("vendor_id", "==", uid))

    // 替换getDoc为getDocs，处理集合查询结果
    getDocs(userQuery)
      .then((querySnapshot) => {
        // 一个UID对应唯一商家，取第一个匹配结果
        if (!querySnapshot.empty) {
          const doc = querySnapshot.docs[0];
          const vdata = doc.data();
          console.log(vdata);
          shopNameElement.textContent = vdata.shop_name;
        } else {
          shopNameElement.textContent = "未找到商家信息";
        }
      })
      .catch((err) => {
        console.error("获取商家信息出错:", err);
      })

  } else {
    shopNameElement.textContent = "您未登录";
  }
})

解决方案2：直接用UID作为文档ID（推荐） #

如果注册商家时，直接把Firestore文档ID设置为用户UID（无需额外存储vendor_id字段），可以跳过查询，直接获取单个文档，效率更高：

const shopNameElement = document.querySelector('.shop_name')
  
onAuthStateChanged(auth, (user) => {
  if (user) {
    const uid = user.uid;
    // 直接通过UID生成目标文档的引用
    const vendorDocRef = doc(vendorRef, uid);

    getDoc(vendorDocRef)
      .then((doc) => {
        if (doc.exists()) {
          const vdata = doc.data();
          console.log(vdata);
          shopNameElement.textContent = vdata.shop_name;
        } else {
          shopNameElement.textContent = "未找到商家信息";
        }
      })
      .catch((err) => {
        console.error("获取商家信息出错:", err);
      })

  } else {
    shopNameElement.textContent = "您未登录";
  }
})

补充说明 #

• 方案2是Firestore的最佳实践，避免了不必要的集合查询，读写性能更好，也更节省数据库资源。
• 两种方案都建议添加错误捕获逻辑，避免未处理的Promise报错影响页面正常运行。

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