本文介绍如何使用 mongodb 聚合管道（`$unwind` + `$replaceroot`）将嵌套在 `bills` 字段中的子文档数组“展平”为顶层文档数组，彻底移除冗余的外层键名，获得纯净的子文档列表。
在 MongoDB 查询中，当你通过投影（projection）仅获取嵌套字段（如 { bills: 1 }）时，返回结果仍会保留原始结构：整个文档以 { bills: [...] } 形式包裹，而非直接返回数组内容。这在前端渲染或 API 响应中往往不符合预期——你真正需要的是扁平化的子文档数组，而非带键名的包装对象。
解决该问题的核心思路是脱离简单查询（find），改用聚合管道（aggregate）进行结构转换。具体需两个关键阶段：
- $unwind：将 bills 数组展开为多条独立文档（每条对应一个子文档）；
- $replaceRoot：将每个展开后的子文档（即 $bills）提升为新的根文档，从而消除外层 bills 字段。
✅ 正确的聚合查询示例如下（Node.js + MongoDB Driver）：
const { ObjectId } = require('mongodb');
const billsList = await record.aggregate([
{ $match: { _id: new ObjectId(billId) } },
{ $unwind: '$bills' },
{ $replaceRoot: { newRoot: '$bills' } }
]).toArray();✅ 输出结果即为你所需的格式：[ { "_id": "64b6d9a71dd7cfdb0aba40c0", "title": "Month1" }, { "_id": "62b6d9a71dd7cfdb0aba40c0", "title": "Month2" } ]
? 注意事项与最佳实践：
- 若 bills 字段可能为空或不存在，建议添加 $match: { "bills.0": { $exists: true } } 或使用 $unwind: { path: "$bills", preserveNullAndEmptyArrays: false } 避免报错；
- 在 Mongoose 中，可链式调用 .aggregate().match().unwind().replaceRoot()，语法更简洁（见答案中示例）；
- 避免在高并发场景下对大数组频繁 $unwind，可能影响性能；必要时可结合索引（如在 _id 上建索引）优化匹配速度；
- 若需保留父文档其他字段（如关联的 recordId），可在 $replaceRoot 前使用 $addFields 注入，再通过 $project 精确控制输出字段。
总之，$unwind + $replaceRoot 是处理“去壳取值”类需求的标准范式。它不依赖应用层循环处理，完全在数据库侧完成结构重塑，高效、声明式且易于维护。
