Mongoose查询返回null问题：为何匹配不到MongoDB目标文档？

为什么查询返回null？ #

核心有两个原因：

• 类型不匹配：数据库中u._id是ObjectId类型，但查询里传入的是字符串格式ID。Mongoose不会自动将字符串转换为嵌套对象字段的ObjectId，直接导致匹配失败。
• 嵌套对象精确匹配逻辑：当直接写u: {_id: "...", username: "..."}时，MongoDB会执行整个嵌套对象的精确匹配——不仅要求字段值一致，还要求字段顺序、对象结构完全和数据库文档一致。类型不匹配的情况下，自然匹配不到数据。

修正后的查询代码 #

推荐用点符号指定嵌套字段的方式，既规避类型问题，也更灵活：

const mongoose = require('mongoose');
let query = {
  "u._id": mongoose.Types.ObjectId("621d3469dd01e282b9a62321"),
  "u.username": "helxsz",
  t: 'd'
};
collection.findOne(query, 'u t').exec(getResult);

如果坚持匹配整个u对象，只需修正_id的类型即可：

const mongoose = require('mongoose');
let query = {
  u: {
    _id: mongoose.Types.ObjectId("621d3469dd01e282b9a62321"),
    username: "helxsz"
  },
  t: 'd'
};
collection.findOne(query, 'u t').exec(getResult);

注意事项 #

点符号查询嵌套字段更稳妥，哪怕未来u对象新增其他字段，也不会影响当前查询的匹配结果；而匹配整个对象的方式，一旦u对象结构变化（比如新增字段），原有查询就会失效。

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