$unwind 报错“path not found”主因是字段名错误、路径不存在或值为null/缺失；安全处理嵌套数组需分步$unwind并启用preservenullandemptyarrays；为防数据丢失应补索引和原数组长度。
$unwind 会把文档中某个数组字段“炸开”成多条文档，每条对应数组里的一个元素。它不是万能的数组遍历工具，用错场景反而会让数据膨胀、查询变慢甚至报错。
为什么 $unwind 报错 “Path not found”？
常见于字段不存在或路径写错，比如数组实际叫 tags，却写了 $unwind: "$tag"；或者字段存在但值为 null 或缺失，而没加保护。
- 检查字段是否存在：用
db.collection.findOne({})确认目标字段名和结构 - 允许空/缺失值：加上
preserveNullAndEmptyArrays: true选项，避免跳过整条文档 - 错误示例：
{$unwind: "$items"}→ 实际字段是orderItems，路径不匹配直接报错
如何安全地 $unwind 嵌套数组（如 orders.items）？
不能直接写 $unwind: "$orders.items" —— MongoDB 不支持点号路径展开嵌套数组，必须分步处理。
- 先
$unwind外层数组：{$unwind: "$orders"} - 再
$unwind内层数组：{$unwind: "$orders.items"} - 如果某条订单
items是空数组或null，第二步会失败，所以建议第二步加preserveNullAndEmptyArrays: true - 性能注意：两层
$unwind可能导致文档数量指数级增长，查前先count()预估规模
怎么避免 $unwind 后丢失原始文档信息？
拆分后每条记录只保留数组的一个元素，原始其他字段还在，但容易被忽略的是：没有自动标记“这是第几个元素”或“原数组长度”。
- 用
$addFields+$indexOfArray补索引：{$addFields: {itemIndex: {$indexOfArray: ["$items", "$$this"]}}} - 用
$size记录原数组长度：{$addFields: {totalItems: {$size: "$items"}}} - 别依赖
$$ROOT直接引用：$unwind后$$ROOT指的是当前已拆分的那条文档，不是原始父文档
最常被忽略的是空数组和 null 的默认行为 —— 它们会让整条文档消失，除非显式启用 preserveNullAndEmptyArrays。线上聚合管道里漏掉这个开关，可能让统计结果少掉一大块数据，而且很难排查。
