MongoDB如何从子文档数组匹配项中仅返回指定字段？

文档结构 #

{
  "_id": ObjectID(),
  "foo": "FOO",
  "bar": "BAR",
  "items": [
    {
      "foo": "FOO",
      "bar": "BAR",
      "name": "hello",
      "value": "50"
    },
    {
      "foo": "FOO",
      "bar": "BAR",
      "name": "bye",
      "value": "300"
    },
    {
      "foo": "FOO",
      "bar": "BAR",
      "name": "welcome",
      "value": "500"
    }
  ]
}

查询需求 #

需要从items数组中筛选出同时满足以下条件的子文档：

• name = "hello"
• value != "0"
  且仅返回匹配项的value字段，期望结果格式如下：

[
  { value: "50" },
  { value: "100" },
  { value: "30" },
  …
]

已尝试的方法 #

普通查询（无法满足字段需求） #

使用$elemMatch筛选文档，但投影只能返回整个匹配的子文档，无法单独提取value字段：

// 筛选条件
{
  items: {
    $elemMatch: {
      name: "hello",
      value: { $ne: "0" },
    },
  }
}

// 投影设置
{ 
  "_id": 0,
  "items.$": 1
}

聚合查询（能实现但担心性能） #

通过$unwind展开数组后筛选，再提取字段，能得到预期结果，但担心$unwind会带来性能开销：

[
  {
    $unwind: {
      path: "$items"
    }
  },
  {
    $match: {
      "items.name": "hello",
      "items.value": { $ne: "0" },
    }
  },
  {
    $replaceRoot: {
      newRoot: "$items"
    }
  },
  {
    $project: {
      "value": 1
    }
  }
]

优化方案 #

方案1：$filter + $map组合（推荐） #

先在投影阶段用$filter筛选符合条件的数组元素，再用$map提取目标字段，最后调整格式。这种方式避免了先展开整个数组，减少中间文档数量，性能更优：

[
  {
    $project: {
      _id: 0,
      matchedValues: {
        $map: {
          input: {
            $filter: {
              input: "$items",
              cond: {
                $and: [
                  { $eq: ["$$this.name", "hello"] },
                  { $ne: ["$$this.value", "0"] }
                ]
              }
            }
          },
          as: "item",
          in: { value: "$$item.value" }
        }
      }
    }
  },
  { $unwind: "$matchedValues" },
  { $replaceRoot: { newRoot: "$matchedValues" } }
]

逻辑说明：

1. $filter：直接在原文档的items数组中筛选符合条件的元素，只保留需要的数据
2. $map：将筛选后的每个元素转换成仅包含value的对象
3. $unwind + $replaceRoot：把数组格式转换成期望的单个对象组成的数组

方案2：索引优化（配合任何查询方式） #

如果这类查询频率高，建议创建复合索引：

db.collection.createIndex({ "items.name": 1, "items.value": 1 })

索引能让MongoDB快速定位到包含匹配子文档的父文档，减少全表扫描的开销，不管用哪种查询方式都能受益。

为什么原聚合性能差？ #

原方案中$unwind会把每个数组元素拆成独立文档，如果items数组很大，会生成大量中间文档，增加内存占用和处理时间。而$filter是在文档层面直接处理数组，先筛选再处理，中间数据量小得多，性能更优。

内容的提问来源于stack exchange，提问作者Slava Fomin II