如何从 MongoDB 中提取子文档数组并扁平化为顶层文档列表

霞舞 2026-01-06 00:00:00 次阅读

本文介绍如何使用 mongodb 聚合管道（`$unwind` + `$replaceroot`）将嵌套在字段（如 `bills`）中的子文档数组提取为扁平化的文档列表，彻底移除外层包装字段，满足前端或业务逻辑对纯数组结构的需求。

在 MongoDB 查询中，当你使用 .find() 并指定 { bills: 1 } 投影时，返回结果仍会保留原始结构：即整个 bills 字段作为键，其值才是目标数组。这导致你得到的是形如 { bills: [ {...}, {...} ] } 的对象，而非直接的 [ {...}, {...} ] 数组——而这正是许多场景（如 React 渲染列表、API 响应直出）所期望的格式。

要实现「去字段包装、展平数组」，必须使用聚合管道（Aggregation Pipeline），而非基础查询。核心思路是两步操作：

$unwind：将 bills 数组拆分为多条独立文档，每条包含数组中的一个子文档；
$replaceRoot：将每个子文档提升为根文档，彻底剥离原父级结构。

✅ 正确的聚合写法如下（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 为空数组（[]），默认 $unwind 会丢弃该文档。如需保留（返回空数组），请改用 { $unwind: { path: '$bills', preserveNullAndEmptyArrays: true } }。
性能考虑：聚合操作比简单 find() 开销略高，但对单文档内嵌数组展开属轻量级操作，无需担忧；若需高频调用，可确保 bills 字段已建立必要索引（尽管本例中不涉及过滤子文档字段）。

Mongoose 用户：语法更简洁，推荐链式调用：

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

避免常见错误：不要尝试用 JavaScript 在应用层 .map(r => r.bills) —— 这仅适用于 find() 返回单文档含数组字段的情况；而本例原始 find() 结果是 [ { bills: [...] } ]，.map(r => r.bills) 才能得到数组，但前提是确认 find() 只匹配一个文档且结构确定。聚合方案更健壮、语义清晰、可扩展性强（例如后续可追加 $match 筛选特定子文档）。

总之，当你的目标是从嵌套结构中「提取并展平子文档数组」时，$unwind + $replaceRoot 是 MongoDB 官方推荐、高效且精准的标准解法。