如何从 MongoDB 中提取子文档数组并去除外层字段包装

本文介绍如何使用 mongodb 聚合管道（`$unwind` + `$replaceroot`）将嵌套在字段（如 `bills`）中的子文档数组“扁平化”为纯数组，彻底移除外层键名，直接返回子文档列表。

在使用 MongoDB 查询时，若目标数据以子文档形式嵌套在某个字段（例如 bills: [...]）中，直接使用 .find() 配合投影（{ bills: 1 }）仅能返回带包装结构的结果（如 { bills: [...] }），无法直接获取纯净的子文档数组。要实现「去字段标签」效果——即从 {"bills": [{...}, {...}]} 提取为 [{}, {}]——必须借助聚合管道。

核心思路是两步操作：

1. $unwind：将 bills 数组展开为多条文档，每条包含一个子文档（如 bills: { _id: ..., title: ... }）；
2. $replaceRoot：将每条文档的根节点替换为该子文档本身（即 $bills），从而彻底剥离原始字段层级。

✅ 正确写法（Node.js + MongoDB Driver）

const { ObjectId } = require('mongodb');
// 假设 client.db().collection('records') 为你的集合实例
const billsList = await collection.aggregate([
  { $match: { _id: new ObjectId(billId) } },
  { $unwind: '$bills' },
  { $replaceRoot: { newRoot: '$bills' } }
]).toArray();

✅ Mongoose 写法（推荐链式调用）

const billsList = await Record.aggregate()
  .match({ _id: new ObjectId(billId) })
  .unwind('$bills')
  .replaceRoot('$bills')
  .toArray();

⚠️ 注意事项

• $unwind 对空数组或 null 字段默认报错，如需容错，可添加 { preserveNullAndEmptyArrays: true } 选项；
• 若原始文档含其他字段（如 name, createdAt），$replaceRoot 后这些字段将完全丢失——这是预期行为，因目标仅为提取子文档；
• 性能方面：$unwind 会产生中间文档膨胀，大数据量时建议配合索引（如在 _id 上建索引）及必要时加 .limit() 控制结果规模。

✅ 输出效果对比

输入文档结构：

{
  "_id": "64b6d9a71dd7cfdb0aba40c0",
  "bills": [
    { "_id": "64b6d9a71dd7cfdb0aba40c0", "title": "Month1" },
    { "_id": "62b6d9a71dd7cfdb0aba40c0", "title": "Month2" }
  ]
}

执行上述聚合后，billsList 将直接是：

[
  { "_id": "64b6d9a71dd7cfdb0aba40c0", "title": "Month1" },
  { "_id": "62b6d9a71dd7cfdb0aba40c0", "title": "Month2" }
]

至此，你已获得真正意义上的“子文档数组”，可直接用于前端渲染、批量处理或进一步聚合计算。