如何用Mongoose根据_id返回指定嵌套文档？

问题场景 #

你的集合数据结构如下：

[
  {
    "_id": "637cbf94b4741277c3b53c6c",
    "text": "outter",
    "username": "test1",
    "address": [
      {
        "text": "inner",
        "username": "test2",
        "_id": "637cbf94b4741277c3b53c6e"
      }
    ],
    "__v": 0
  }
]

你想通过嵌套文档的_id搜索并返回该嵌套文档，执行了以下查询语句：

db.collection.find({
  _id: "637cbf94b4741277c3b53c6c"
},
{
  address: {
    $eq: {
      _id: "637cbf94b4741277c3b53c6e"
    }
  }
})

结果触发报错：

query failed: (Location16020) Expression $eq takes exactly 2 arguments. 1 were passed in.

错误原因 #

你在查询的投影阶段（第二个参数）错误使用了$eq运算符：

• $eq是比较运算符，要求必须传入两个操作数（比如$eq: [字段值, 目标值]），但你只传了一个对象，不符合语法规则。
• 投影阶段不能直接用$eq来过滤数组中的嵌套文档，这种写法本身就不被MongoDB支持。

正确解决方案 #

要返回数组中匹配的嵌套文档，推荐两种常用方法：

方法1：使用$elemMatch进行投影 #

db.collection.find(
  { _id: "637cbf94b4741277c3b53c6c" },
  { address: { $elemMatch: { _id: "637cbf94b4741277c3b53c6e" } } }
)

$elemMatch会在address数组中找到第一个符合_id条件的元素，并仅返回该元素。

方法2：使用聚合管道（支持返回所有匹配元素） #

如果数组中有多个符合条件的嵌套文档，或者需要更复杂的处理逻辑，用聚合管道更灵活：

db.collection.aggregate([
  // 先匹配外层文档
  { $match: { _id: "637cbf94b4741277c3b53c6c" } },
  // 展开address数组
  { $unwind: "$address" },
  // 过滤出目标嵌套文档
  { $match: { "address._id": "637cbf94b4741277c3b53c6e" } },
  // 将匹配的嵌套文档作为根文档返回
  { $replaceRoot: { newRoot: "$address" } }
])

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