Mongoose如何获取MongoDB深度嵌套子文档的扁平化数组

可选实现路径 #

你可以选择两种方式拿到目标一维任务数组：一是通过MongoDB聚合管道直接在查询阶段输出扁平化结果，二是查询到原始嵌套数据后通过JavaScript代码做结构转换。 #

方案1：聚合查询直接返回目标结构 #

使用MongoDB原生聚合管道可以在数据库侧完成数组拆分、结构重组，直接返回一维任务数组，无需额外后处理，性能更优。
核心聚合阶段说明：

• $match：筛选指定uid的用户文档
• 两层$unwind：先后拆分外层contacts数组、内层contacts.tasks数组，把嵌套数组拆成单条记录
• $replaceRoot：将内层的task对象提升为结果的根节点，去掉外层嵌套结构
  完整代码示例：

User.aggregate([
  { $match: { uid: Number(req.params.uid) } },
  { $unwind: "$contacts" },
  { $unwind: "$contacts.tasks" },
  { $replaceRoot: { newRoot: "$contacts.tasks" } }
]).exec((err, tasks) => {
  if (err) return res.status(500).send(err);
  res.send(tasks);
});

如果需要保留没有任务的联系人对应的空记录，可以给第二个$unwind加配置：{ $unwind: { path: "$contacts.tasks", preserveNullAndEmptyArrays: true } }

方案2：查询后通过JavaScript扁平化 #

如果你不想使用聚合语法，可以在修正原有查询代码的基础上，对返回结果做数组扁平化处理。
注意：你原有代码存在两个显性bug：Mongoose查询回调第一个参数固定为错误对象，第二个才是查询结果，你写反了参数顺序，同时存在yasks/tasks变量名拼写错误，会直接导致逻辑异常。
完整代码示例：

User.findOne({ uid: Number(req.params.uid) }, 'contacts.tasks', (err, user) => {
  if (err) return res.status(500).send(err);
  if (!user) return res.status(404).send({ message: "用户不存在" });

  // 方式1：兼容所有Node版本的reduce写法
  const tasks = user.contacts.reduce((res, contact) => {
    return res.concat(contact.tasks || []);
  }, []);

  // 方式2：ES2019+支持的flatMap写法，更简洁
  // const tasks = user.contacts.flatMap(contact => contact.tasks || []);

  res.send(tasks);
});

方案选型参考 #

• 数据量较大、仅需要返回任务列表时，优先选择聚合方案，减少网络传输开销和服务端计算压力
• 数据量小、查询后还需要用到用户/联系人其他字段时，选择JS后处理方案即可，代码可读性更高

内容的提问来源于stack exchange，提问作者Wil Smith