本文介绍如何使用 mongodb 聚合管道（`$unwind` + `$replaceroot`）将嵌套在字段（如 `bills`）中的子文档数组“扁平化”为纯数组，彻底移除外层键名，直接返回子文档列表。
在使用 MongoDB 查询时，若目标数据以子文档形式嵌套在某个字段（例如 bills: [...]）中，直接使用 .find() 配合投影（{ bills: 1 }）仅能返回带包装结构的结果（如 { bills: [...] }），无法直接获取纯净的子文档数组。要实现「去字段标签」效果——即从 {"bills": [{...}, {...}]} 提取为 [{}, {}]——必须借助聚合管道。
核心思路是两步操作：
- $unwind：将 bills 数组展开为多条文档，每条包含一个子文档（如 bills: { _id: ..., title: ... }）；
- $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" }
]至此，你已获得真正意义上的“子文档数组”，可直接用于前端渲染、批量处理或进一步聚合计算。
