为何MongoDB/Mongoose传入null/undefined的find查询返回全部文档？

这个问题其实是MongoDB驱动的默认容错行为导致的，完全属于正常现象，我来给你拆解清楚：

背后的原因 #

• MongoDB的find()方法对传入的查询参数有自动解析逻辑：当你传入null或者undefined时，驱动会把这些无效值自动替换成空对象{}。而find({})本身就是查询集合内所有文档的标准语法，所以自然会返回全部结果。
• 驱动这么做是出于“容错”考虑：它认为null/undefined不属于合法的查询条件文档，与其直接抛出错误中断程序，不如兜底执行一个“匹配所有”的查询，保证代码能继续运行。

这属于正常现象吗？ #

绝对是正常的设计，不是Bug。MongoDB官方驱动的逻辑就是优先保证查询的可执行性，对非合法的查询条件做默认兜底处理，只是这个行为和你的预期不符而已。

如何实现“参数无效时返回空结果”的需求？ #

如果你希望当查询参数是null/undefined时不返回任何文档，可以在代码里手动加一层判断，提前处理这种情况：

方案1：直接返回空数组（最高效，不用查库） #

async function fetchDocuments(queryParam) {
  // 同时判断null和undefined
  if (queryParam == null) {
    return [];
  }
  return await exampleModel.find(queryParam).lean().exec();
}

方案2：传入一个永远匹配不到的查询条件 #

如果必须走数据库查询流程，可以用一个恒假条件，比如：

const effectiveQuery = queryParam ?? { $expr: { $eq: [1, 0] } };
const result = await exampleModel.find(effectiveQuery).lean().exec();

{ $expr: { $eq: [1, 0] } }是永远不会匹配到任何文档的条件，会直接返回空结果。

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