17370845950

本文介绍如何使用 mongodb 聚合管道（`$unwind` + `$replaceroot`）将嵌套在 `bills` 字段中的子文档数组“展平”为顶层文档数组，彻底移除冗余的外层键名，获得纯净的子文档列表。

在 MongoDB 查询中，当你通过投影（projection）仅获取嵌套字段（如 { bills: 1 }）时，返回结果仍会保留原始结构：整个文档以 { bills: [...] } 形式包裹，而非直接返回数组内容。这在前端渲染或 API 响应中往往不符合预期——你真正需要的是扁平化的子文档数组，而非带键名的包装对象。

解决该问题的核心思路是脱离简单查询（find），改用聚合管道（aggregate）进行结构转换。具体需两个关键阶段：

1. $unwind：将 bills 数组展开为多条独立文档（每条对应一个子文档）；
2. $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 是处理“去壳取值”类需求的标准范式。它不依赖应用层循环处理，完全在数据库侧完成结构重塑，高效、声明式且易于维护。