MongoDB 用 $not: null 查询非空字段时报 invalid use of $not

想查询“字段已经存在，而且不是 null”的文档，写成下面这样却报 invalid use of $not：

db.records.find({ result: { $exists: true, $not: null } })

$not 不能直接接一个普通的 null 值作为比较条件。对顶层标量字段，查询存在且非 null 的值，可以写成：

db.records.find({ result: { $ne: null } })

records 和 result 是示例集合、字段名，使用时替换为实际名称。这里采用 mongosh 查询语法，限定字段为顶层标量；数组及穿过数组的点路径，不能直接套用这组判断。

存在、空值和有效业务值并不相同

$exists: true 只检查字段是否存在，显式存了 null 的字段同样存在。对于顶层标量字段，$ne: null 才表达“存在且不是 null”。

可以按下面四种文档形态核对预期结果：

{ _id: 1 }
{ _id: 2, result: null }
{ _id: 3, result: "" }
{ _id: 4, result: "ready" }

这些是用于说明语义的文档，不是要求向业务集合插入的数据。$exists: true 会选中 2、3、4；$ne: null 会选中 3、4。空字符串仍然不是 null，数值 0、布尔值 false 也不是 null，不能把这条过滤器称作“筛掉所有无效值”。

若字段应当是非空字符串，还需要按数据模型增加类型和内容条件。这是额外的业务校验，不能靠把 $ne 改成 $exists 自动完成。

只找缺失字段的文档：

db.records.find({ result: { $exists: false } })

同时找缺失字段和显式 null：

db.records.find({ result: null })

对于本文限定的标量字段，只找显式 BSON null：

db.records.find({ result: { $type: 10 } })

10 是 BSON Null 的类型编号。不要用字符串 "null" 代替 null，也不要把字符串 "true"、"false" 当作 $exists 所需的布尔值。驱动中的表示方法要遵守所用语言，例如 Python 使用 None 表示这里的空值。

修复 $not 的语法时，也不要把任意“不等于某值”的条件都解释为排除缺失字段。本文的 $ne: null 有明确的空值查询语义，不能推广成 $ne 对所有比较值都会要求字段存在。

字段可能是数组时，null 比较还会检查数组元素。比如包含 null 元素的数组与空数组，不会得到与普通标量完全一样的结果。

点路径如果穿过数组，差异会更明显：{ "items.result": { $ne: null } } 不一定等价于“每个文档确实存在一个非空的 items.result”。空数组等形态可能使不等于 null 与字段存在检查得到不同结果。

因此，先检查字段实际 BSON 类型与层级，再决定要匹配一个元素、全部元素，还是整个字段。需要数组条件时应按对应数组语义重新构造查询，不能为了让结果数量看起来正确就删除 $exists 或批量补字段。

在获准的数据范围内，用投影查看少量结果，例如：

db.records.find(
  { result: { $ne: null } },
  { _id: 1, result: 1 }
).limit(20)

把已有租户、权限和业务范围条件保留在实际查询中。检查样本里是否仍有不允许的空字符串、错误类型，以及字段是否真的位于预期层级。少量样本用于核对语义，不能证明全表都符合模型。

不要只为这处语法错误删除索引、改唯一约束，或给所有缺失字段填默认值。查询速度应结合实际数据分布与执行计划评估，不能保证把 $exists 换成 $ne 就更快。

这是读取条件的修正，不要求修改文档内容。保存原过滤器，先对受控样本比较缺失、显式 null 和普通值的结果，再接回应用。若过滤器还用于更新或删除，先以只读查询核对全部影响范围；语法正确不等于写入范围已经获得确认。