MongoDB查询父文档时如何仅返回匹配条件的子文档

普通find查询默认会返回匹配父文档的完整数组内容，要实现保留父文档字段、仅返回数组中符合筛选条件的子文档，根据你的匹配项数量需求，选下面两种写法即可：

• 仅需要返回数组中第一个匹配的子文档：用$elemMatch投影，所有MongoDB版本通用，性能更好
• 需要返回数组中所有匹配的子文档：用聚合管道的$filter操作符，MongoDB 3.2及以上版本支持

写法1：$elemMatch投影（单匹配项场景） #

直接在find的第二个参数（投影配置）中，对数组字段使用$elemMatch指定匹配规则即可，对应你的示例代码：

db.collection.find(
  // 父文档筛选条件
  { jobId: "job1", "testData.name": "block3" },
  // 返回字段配置+数组过滤规则
  {
    testname: 1,
    jobId: 1,
    vt_cond: 1,
    testData: { $elemMatch: { name: "block3" } }
  }
)

执行后返回的结果和你预期完全一致：父文档的普通字段全部保留，testData数组仅包含第一个匹配name: "block3"的子文档。
注意：该写法只会返回数组中第一个命中条件的元素，如果数组内有多个符合条件的项，其余项会被丢弃。

写法2：聚合管道$filter（多匹配项场景） #

如果数组中可能存在多个符合筛选条件的子文档，需要全部返回，就用聚合管道实现，示例代码：

db.collection.aggregate([
  // 第一步：筛选符合条件的父文档，和普通find查询逻辑一致
  { $match: { jobId: "job1", "testData.name": "block3" } },
  // 第二步：投影字段，过滤目标数组
  {
    $project: {
      testname: 1,
      jobId: 1,
      vt_cond: 1,
      testData: {
        $filter: {
          input: "$testData", // 要过滤的数组字段路径
          as: "tdItem", // 遍历数组时的元素别名
          cond: { $eq: ["$$tdItem.name", "block3"] } // 元素匹配规则，支持多条件组合
        }
      }
    }
  }
])

该写法没有匹配条数限制，所有符合条件的数组元素都会被保留，同时支持更复杂的匹配逻辑（比如同时匹配chip和name字段、范围匹配等）。

避坑提示：MongoDB的查询条件仅负责判断父文档是否符合返回要求，不会自动对数组内容做裁剪。只要数组内有任意一个元素命中查询条件，整个父文档连带完整数组都会被纳入返回结果，数组裁剪必须在投影阶段单独配置规则。

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