MongoDB中如何确保数组字段无匹配时仍返回空数组结构？

问题场景 #

我的MongoDB teams 集合中有如下文档结构：

{
  _id: ObjectId('...'),
  name: 'Team A',
  players: [
    {
      name: 'Michael',
      position: 'Goalkeeper'
    },
    {
      name: 'Frank',
      position: 'Defender'
    }
  ]
}

我原本使用以下聚合管道按位置筛选球员：

[
  {
    '$match': {
      '_id': ObjectId('...'),
      'name': 'Team A'
    }
  },
  {
    '$unwind': {
      'path': '$players'
    }
  },
  {
    '$match': {
      'players.position': 'Goalkeeper'
    }
  },
  {
    '$group': {
      '_id': null,
      'players': {
        '$addToSet': '$players'
      }
    }
  },
  {
    '$project': {
      '_id': 0
    }
  }
]

筛选存在的位置（如门将）时返回结果符合预期，但筛选不存在的位置（如前锋）时，会返回空数组 []，我需要无匹配时固定返回 {players: []}。

解决方案 #

方法一：使用$filter简化管道（推荐） #

直接用$filter在原文档的players数组上执行过滤，无需拆分数组再重组，效率更高且天然支持空结果返回：

[
  {
    '$match': {
      '_id': ObjectId('...'),
      'name': 'Team A'
    }
  },
  {
    '$project': {
      '_id': 0,
      'players': {
        '$filter': {
          'input': '$players',
          'cond': {'$eq': ['$$this.position', 'Forward']} // 替换为目标位置
        }
      }
    }
  }
]

• 原理：$filter会遍历players数组，保留符合条件的元素；无匹配时直接返回空数组，最终输出结构始终为{players: [...]}。

方法二：兼容原有管道的修改 #

如果必须保留原有unwind+match+group的逻辑，可通过$unionWith添加默认文档，确保无匹配时返回指定结构：

[
  {
    '$match': {
      '_id': ObjectId('...'),
      'name': 'Team A'
    }
  },
  {
    '$unwind': {
      'path': '$players'
    }
  },
  {
    '$match': {
      'players.position': 'Forward'
    }
  },
  {
    '$group': {
      '_id': null,
      'players': {
        '$addToSet': '$players'
      }
    }
  },
  {
    '$project': {
      '_id': 0
    }
  },
  {
    '$unionWith': {
      'coll': 'teams',
      'pipeline': [
        {'$limit': 0},
        {'$project': {'_id': 0, 'players': []}}
      ]
    }
  },
  {
    '$limit': 1
  }
]

• 原理：$unionWith会将原有管道的结果和一个生成的默认文档合并，$limit:1确保只返回一个结果——有匹配时返回筛选后的文档，无匹配时返回默认的{players: []}。

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