Firebase Cloud Firestore查询示例返回无效对象问题咨询

你遇到的核心问题是Firestore查询是惰性执行的——你用where()创建的query只是一个「查询规则对象」，它并没有实际向Firebase服务器发起请求、获取匹配的文档数据。直接console.log(query)打印的只是这个规则的描述，自然不管你查什么值，输出的都是类似的对象结构。

正确获取查询结果的方式 #

Firestore提供两种获取查询结果的方式：

• 一次性获取数据：使用get()方法，它返回一个Promise，会在获取到数据后解析。
• 实时监听数据变化：使用onSnapshot()方法，会在数据首次获取或发生变化时触发回调。

修改你的代码示例 #

下面是针对你的场景的修正版本，用get()来获取匹配的文档：

var citiesRef = db.collection("cities");
// 先完成数据写入（注意：写入操作也是异步的，最好确保写入完成后再查询）
Promise.all([
  citiesRef.doc("SF").set({ name: "San Francisco", state: "CA", country: "USA", capital: false, population: 860000, regions: ["west_coast", "norcal"] }),
  citiesRef.doc("LA").set({ name: "Los Angeles", state: "CA", country: "USA", capital: false, population: 3900000, regions: ["west_coast", "socal"] }),
  citiesRef.doc("DC").set({ name: "Washington, D.C.", state: null, country: "USA", capital: true, population: 680000, regions: ["east_coast"] }),
  citiesRef.doc("TOK").set({ name: "Tokyo", state: null, country: "Japan", capital: true, population: 9000000, regions: ["kanto", "honshu"] }),
  citiesRef.doc("BJ").set({ name: "Beijing", state: null, country: "China", capital: true, population: 21500000, regions: ["jingjinji", "hebei"] })
]).then(() => {
  // 写入完成后执行查询
  var query = citiesRef.where("state", "==", "CA");
  // 通过get()获取查询结果
  query.get().then((querySnapshot) => {
    if (querySnapshot.empty) {
      console.log("没有匹配的文档");
      return;
    }
    // 遍历所有匹配的文档
    querySnapshot.forEach((doc) => {
      console.log(doc.id, "=>", doc.data());
    });
  }).catch((error) => {
    console.error("查询出错:", error);
  });
}).catch((error) => {
  console.error("写入数据出错:", error);
});

为什么之前的输出始终一致？ #

你打印的query对象是Firestore的Query实例，它仅包含查询的条件（比如集合路径、过滤规则），而不包含实际的查询结果。不管你设置的过滤条件是否有匹配的文档，这个实例的结构都是类似的，所以输出看起来没有区别。只有当你调用get()或onSnapshot()时，Firestore才会真正执行查询，从服务器获取数据并返回结果。

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