mongoose使用$elemMatch查询时返回全部数组元素而非首个匹配项如何解决

问题原因 #

你遇到的返回全数组的问题，核心有两点：

1. 查询过滤条件不匹配：你提供的样例数据中，文档的user_id字段值为"0"，但你写的查询过滤条件是{user_id:"123123123"}，该条件无法命中你给出的测试文档。$elemMatch作为投影操作符时，如果查询未命中任何文档，或是目标数组中没有符合匹配规则的元素，就不会对数组做过滤，直接返回原数组。
2. 工具兼容性问题：部分ORM框架（比如Mongoose）如果配置了默认投影规则，或是你使用的数据库客户端存在版本兼容问题，也可能导致$elemMatch投影规则失效。

解决方法 #

方法1：修正查询条件（优先尝试）

先把过滤条件修正为匹配你样例数据的规则，原生MongoDB下该写法本身是符合语法的，修正后语句如下：

Reports.find(
  { user_id: "0" },
  { "list": { $elemMatch: { "employee_code": 1111 } } }
)

方法2：使用$位置操作符替代

如果需要更稳定的返回第一个匹配元素，可以在过滤条件中加入数组字段的匹配规则，搭配$位置操作符实现效果：

Reports.find(
  { user_id: "0", "list.employee_code": 1111 },
  { "list.$": 1 }
)

注意：该写法要求过滤条件必须包含数组字段的匹配规则，否则查询会报错。

方法3：使用聚合管道实现（适合复杂场景）

如果上述方案都不生效，或是你需要更灵活的数组过滤逻辑，可以用聚合管道实现：

Reports.aggregate([
  // 匹配文档
  { $match: { user_id: "0" } },
  // 过滤数组并取第一个匹配项
  {
    $project: {
      user_id: 1,
      list: {
        $first: {
          $filter: {
            input: "$list",
            cond: { $eq: ["$$this.employee_code", 1111] }
          }
        }
      }
    }
  }
])

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