Firebase Firestore如何查询缺失键及未设置值的文档？

刚上手Firestore确实会遇到这类查询的小细节坑，我来帮你彻底解决这个问题——正好你要的「捕获缺失键+键值为null」的需求，Firestore有个简洁的实现方式，而且是官方默认支持的逻辑。

核心方法：用where(字段名, "==", null) #

Firestore的查询规则里有个很实用的隐含逻辑：当你查询某个字段等于null时，会同时返回两类文档：

• 该字段完全不存在的文档（也就是你说的「缺失指定键」的情况）
• 该字段存在，但值明确设为null的文档

而你提到的undefined，Firestore是不允许存储的——如果写入时给某个字段传undefined，这个字段根本不会被写入到文档里，相当于「缺失键」的情况，所以也会被这个查询捕获到。

代码示例（不同SDK版本） #

Web SDK v9+（模块化）

import { collection, query, where, getDocs } from "firebase/firestore";

// 替换成你的集合名和目标字段名
const targetCollection = collection(db, "your-collection-name");
const q = query(targetCollection, where("your-target-field", "==", null));

// 执行查询
const querySnapshot = await getDocs(q);
querySnapshot.forEach((doc) => {
  console.log(`匹配的文档ID：${doc.id}，数据：`, doc.data());
});

Web SDK v8（命名空间）

// 替换成你的集合名和目标字段名
db.collection("your-collection-name")
  .where("your-target-field", "==", null)
  .get()
  .then((querySnapshot) => {
    querySnapshot.forEach((doc) => {
      console.log(`匹配的文档ID：${doc.id}，数据：`, doc.data());
    });
  })
  .catch((error) => {
    console.error("查询出错：", error);
  });

为什么之前的查询可能失败？ #

很多新手会尝试用!=或者not-in这类操作符，但Firestore的不等查询（比如!=、<、>）只会包含存在该字段的文档，完全缺失该字段的文档会被直接排除，这就是你之前测试不到结果的原因。

额外说明：如果只想单独捕获「缺失键」 #

如果你之后有需求，只想找字段完全不存在、排除值为null的文档，Firestore本身不支持直接做这个区分（因为缺失字段被视为null）。这时候需要在写入文档时做额外处理：比如给需要标记「缺失」的字段设置一个特殊值（比如"FIELD_MISSING"），然后查询where("your-target-field", "==", "FIELD_MISSING")——当然这需要调整你的写入逻辑配合。

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