$unwind + $match 是提取数组中匹配子文档字段的正确方法，需加 preserveNullAndEmptyArrays 选项防错，ObjectId 查询前须转换，单值结果用 $limit:1 配合取值。
用 $unwind + $match 提取数组中匹配的子文档
当你需要从嵌套数组（比如 comments 或 pictures）里精准捞出某一条满足条件的子文档，并只返回它的某个字段（如 likes），$unwind 是绕不开的第一步。它把数组“摊平”成多条独立文档，让后续 $match 能真正作用于每个子项。
常见错误是直接在 find() 里用 $elemMatch ——它只能过滤出包含匹配子项的父文档，但返回的仍是整个数组，无法单独提取子文档字段。
-
$unwind默认遇到空数组或缺失字段会报错；若数据不规整，务必加{ preserveNullAndEmptyArrays: true } - 匹配子文档 ID 时，确保传入的是合法
ObjectId；字符串需先用new mongoose.Types.ObjectId(str)转换 - 若只需一个值（如数字），最后加
$limit: 1并用.then(res => res[0]?.likes)取值，避免包装成数组
用 $filter 在内存中筛掉归档/无效子文档
当父文档字段存的是 ObjectId 数组（如 workbooks: [ObjectId("..."), ...]），而你要排除关联子文档中 isArchived: true 的项，$lookup 拉完全部再筛最稳妥。MongoDB 原生不支持在 $lookup 的 localField 上直接加子文档条件，5.0+ 的 pipeline 选项对数组引用字段效果也受限。
正确顺序是：$match 定位父文档 → $lookup 关联子集合 → $set + $filter 对已加载的数组二次过滤。
-
$filter的cond写{$ne: ["$$this.isArchived", true]}，能同时保留isArchived: false和字段缺失的文档 - 别用
$addToSet替代$push：前者去重，但同一name可能在不同版本子文档中重复出现，必须保留全部 -
$filter是内存操作，性能取决于拉取后的数组大小；若子文档量极大，得评估是否该改用应用层分页过滤
用点号路径 + 查询运算符查嵌套字段值
对简单查询（不涉及跨集合、不需投影子字段），直接用点号路径最轻量。比如查 size.uom === "in" 或 surfaceTemperatureC.mean < -200，find() 就够用。
注意点号必须加引号：{"size.uom": "in"} 合法，{size.uom: "in"} 语法错误。
- 复合条件（AND）不用显式写
$and，多个键并列即可：{"size.h": {$lt: 15}, "size.uom": "in", "status": "D"} - 要匹配整个嵌套对象（如
size: {h: 14, w: 21}），必须写全字段和值，且顺序无关；但不能只写{h: 14}就匹配{h: 14, w: 21} - 点号路径支持数组索引，如
"instock.0.warehouse"取第一个仓库，但一般不推荐硬编码索引，易出错
嵌套 $lookup 处理多级关联
当一个集合（如 store）同时关联多个其他集合（category、sticker、prefix），且要一次性把所有关联详情嵌入，就得在 $lookup 的 pipeline 选项里再套 $lookup。
关键陷阱是字段类型不一致：比如 store.sticker_id 是字符串，但 sticker._id 是 ObjectId，必须在 pipeline 里用 $toObjectId 转换，否则关联失败。
- 嵌套
$lookup的as字段名不能与外层同名，否则会被覆盖 - 每层
$lookup都增加一次网络往返开销，尤其在分片集群上；若只是偶尔需要，考虑应用层两次查询更可控 -
pipeline内的$match是对被关联集合的筛选，不是对当前文档字段的筛选，别混淆作用域
$unwind 的容错配置和 $lookup 中字段类型的隐式转换——它们不会报错，但会静默返回空结果，排查起来特别费时间。 
