Google Cloud Firestore查询时forEach()方法未触发问题

我正在开发搭载Firestore数据库的Web应用，需要查询tasks集合内所有未标记extra、且dept字段值为"MUSH"的文档。
原有代码片段如下：

import { initializeApp } from "firebase/app";
import { getFirestore,
         collection,
         getDocs,
         query,
         where
       } from 'firebase/firestore';

const app = initializeApp(firebaseConfig);
const db = getFirestore(app);

const mush = query(collection(db, "tasks"), where("extra", "!=", "true"), where("dept", "==", "MUSH"));

const mushList = [];
const innerMushList = [];
const weekdayList = []

try {
  const mushSnapshot = await getDocs(mush);
  console.log("checkpoint 1");
  mushSnapshot.forEach((doc) => {
    console.log("checkpoint 2");
    const task = doc.get("task");
    innerMushList.push(task);
    if (doc.get("monday") != null) {
      weekdayList.push("Mon");
    }
    else if (doc.get("tuesday") != null) {
      weekdayList.push("Tue");
    }
    else if (doc.get("wednesday") != null) {
      weekdayList.push("Wed");
    }
    else if (doc.get("thursday") != null) {
      weekdayList.push("Thu");
    }
    else if (doc.get("friday") != null) {
      weekdayList.push("Fri");
    }
    else {}
    innerMushList.push(weekdayList);
    weekdayList = [];
    const time = doc.get("time");
    innerMushList.push(time);
    const staff = doc.get("staff");
    innerMushList.push(staff);
    mushList.push(innerMushList);
    innerMushList = [];
  });
}
catch(error) {
  console.log(error);
}

运行现象：

• 控制台可正常输出checkpoint 1，但始终无法触发forEach回调输出checkpoint 2
• 控制台无任何错误提示
• 打印mushSnapshot得到标注为Mh的空快照对象，无匹配文档

问题由三个Firestore查询规则的误用共同导致：

1. 查询条件顺序错误：Firestore复合查询要求所有相等匹配条件必须放在范围/不等匹配条件之前，原有代码把extra != "true"这个不等条件放在了dept == "MUSH"相等条件之前，不符合查询语法逻辑。
2. !=操作符的匹配限制：Firestore的!=操作符只会返回查询字段实际存在的文档，如果你定义的“未标记extra”是指文档没有extra字段，这类文档会被直接过滤，永远不会出现在返回结果中。
3. 类型不匹配：代码中extra的匹配值是字符串类型的"true"，如果extra字段实际存储的是布尔类型true/false，类型不一致会导致条件永远无法命中。

1. 统一字段数据规范：给tasks集合下所有文档补全extra字段，标记为额外任务的设为布尔值true，未标记的设为布尔值false，不要缺省该字段，从根源避免字段不存在导致的匹配丢失问题。
2. 调整查询条件顺序与逻辑：把相等条件放在最前，替换容易出问题的!=查询为布尔值相等查询，修正后的查询语句如下：

const mush = query(
  collection(db, "tasks"), 
  where("dept", "==", "MUSH"), // 相等条件前置
  where("extra", "==", false) // 直接匹配未标记extra的文档，无范围查询开销
);

3. 创建复合索引：首次运行修正后的代码时，若控制台抛出索引缺失提示，直接按照提示引导在Firebase控制台创建对应复合索引即可，索引字段顺序为dept、extra，绑定tasks集合，索引创建完成后查询即可正常返回结果。

额外优化：原有代码中weekdayList、innerMushList两个数组定义在循环外部，虽然逻辑中做了重置，但更稳妥的写法是把这两个数组的声明移到forEach回调内部，避免异步场景下的数组值污染。

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