MongoDB如何仅返回匹配查询条件的子文档（无需$filter）

问题背景 #

你有这样的MongoDB文档集合：

{ "id" : 1, "widgets" : [ { "name" : "foo", quantity: 1 }, { "name" : "bar", quantity: 3 } ] },
{ "id" : 2, "widgets" : [ { "name" : "baz", quantity: 2 } ] }

想要找到id=1且name="bar"的widgets子文档，最终只返回该子文档：{ "name" : "bar", quantity: 3 }，而且不想用成本较高的聚合$filter操作符，想找纯投影的实现方式。

关于纯投影的局限性 #

首先得明确：如果想完全在数据库端直接返回没有外层包裹的纯子文档，仅靠投影确实做不到。MongoDB的投影功能只能控制字段的显示/隐藏，或者返回数组中第一个匹配条件的元素（通过$占位符），但没办法直接把数组元素提升为根文档。

不过我们有几个轻量化的替代方案，不需要用到$filter：

方案1：投影+客户端简单解析（最推荐，无聚合）

先用find定位目标文档，同时投影只返回匹配的数组元素：

db.yourCollection.find(
  { "id": 1, "widgets.name": "bar" }, // 先筛选出符合条件的文档
  { "widgets.$": 1, _id: 0 } // 只返回匹配的第一个数组元素，隐藏_id
)

这个查询返回的结果是：

{ "widgets" : [ { "name" : "bar", quantity: 3 } ] }

之后在客户端代码里只需要取数组的第一个元素就行，比如在Python里：

result = db.yourCollection.find_one(...)
target_widget = result["widgets"][0]

这个方案完全不用聚合，性能开销极低，只是多了一步客户端的简单解析。

方案2：轻量聚合（比$filter高效）

如果必须在数据库端直接返回纯子文档，可以用更轻量的聚合操作符组合，替代$filter：

db.yourCollection.aggregate([
  // 第一步：过滤出目标文档，减少后续处理的数据量
  { $match: { "id": 1, "widgets.name": "bar" } },
  // 第二步：找到目标子文档在数组中的位置，提取出来
  { $project: {
      _id: 0,
      targetWidget: { 
        $arrayElemAt: [ 
          "$widgets", 
          { $indexOfArray: [ "$widgets.name", "bar" ] } 
        ] 
      }
    }
  },
  // 第三步：把提取出的子文档设为根文档
  { $replaceRoot: { newRoot: "$targetWidget" } }
])

这个管道用$indexOfArray快速定位子文档的位置，再用$arrayElemAt提取，最后用$replaceRoot转换格式，整体性能比$filter要好很多，因为没有遍历整个数组做过滤操作。

总结 #

• 追求极致性能的话，优先选方案1，投影+客户端解析，完全规避聚合开销。
• 必须在数据库端输出纯子文档的话，用方案2的轻量聚合，比$filter更高效。

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