MongoDB Node.js提取数组指定元素失败问题及解决

前提 #

在Linux系统中安装了MongoDB 7.X + MongoDB Node.js驱动（npm版本6.3.0），需从集合的数组字段中提取包含指定元素的完整对象（测试场景仅需单个元素）。

• 未使用Mongoose
• 测试场景中目标数据为单个元素，实际场景需返回包含该元素的完整对象
  参考在线示例编写代码，但本地运行失败，所有尝试方案均无效。

问题过程 #

测试集合数据 #

[
  {
    "_id": "65bb73c6338793c4c38e919e",
    "season-2024": [
      {
        "_id": "65bb73d5338793c4c38e919f",
        "fakedata": 30289
      },
      {
        "_id": "65bb73d5338793c4c38e91a0",
        "fakedata": 268
      },
      {
        "_id": "65bb73d5338793c4c38e91a1",
        "fakedata": 186353
      },
      {
        "_id": "65bb73d5338793c4c38e91a2",
        "fakedata": 7346228
      },
      {
        "_id": "65bb73d5338793c4c38e91a3",
        "fakedata": 23688922
      },
      {
        "_id": "65bb73d5338793c4c38e91a4",
        "fakedata": 98903
      },
      {
        "_id": "65bb73d5338793c4c38e91a5",
        "fakedata": 5270371
      },
      {
        "_id": "65bb73d5338793c4c38e91a6",
        "fakedata": 260862
      },
      {
        "_id": "65bb73d5338793c4c38e91a7",
        "fakedata": 186543
      },
      {
        "_id": "65bb73d5338793c4c38e91a8",
        "fakedata": 1314
      },
      {
        "_id": "65bb73d5338793c4c38e91a9",
        "fakedata": 1468
      },
      {
        "_id": "65bb73d5338793c4c38e91aa",
        "fakedata": 186734
      }
    ]
  }
]

尝试的代码 #

let collection = await params.database.collection( params.collection ) // 返回集合

let finder = await collection.find({},{
    "season-2024": {
      $elemMatch: {
        _id: "65bb73d5338793c4c38e91a0"
      }
    }
}).toArray()

console.log("finder result",finder) 

注：已尝试使用_id: new ObjectId("65bb73d5338793c4c38e91a0")

不符合预期的返回结果 #

[
  {
    _id: new ObjectId('65bb73c6338793c4c38e919e'),
    'season-2024': [
      [Object], [Object],
      [Object], [Object],
      [Object], [Object],
      [Object], [Object],
      [Object], [Object],
      [Object], [Object]
    ]
  }
]

疑问 #

为何在线MongoDB v6测试有效，但本地MongoDB v7无效？问题出在哪里？

解决方案 #

将查询与投影分离为两个独立方法即可解决：

let finder = await collection
                .find({}) // 可添加更多查询条件
                .project({
                    "season-2024": {
                         $elemMatch: {
                            _id: "65bb73d5338793c4c38e91a0"
                         }
                     }
                }).toArray()

官方文档依据 #

MongoDB Node.js驱动的find()方法虽可接受第二个参数作为投影选项，但在配合MongoDB 7.X的部分驱动版本中，直接在该参数内使用$elemMatch可能存在兼容性问题。而project()是驱动官方提供的专门用于声明投影逻辑的API，其行为在各版本中更稳定，符合驱动文档中关于投影操作的规范：明确通过project()方法指定投影，能保证跨版本的兼容性和行为一致性。

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