$位置操作符“没反应”实为误用上下文：items.$替换整个子文档致字段丢失，items.$.name才安全更新单字段；$[i]必须与query条件、arrayfilters三者共存才生效。
为什么 $ 位置操作符在嵌套数组更新中“看似没反应”
不是失效，是用错了上下文。当你写 { $set: { 'items.$': { name: 'x' } } }，MongoDB 确实执行了——但它把整个匹配的 items 数组元素替换成新对象，所有未声明字段（比如 price、stock）全被清空。你看到“没变”，其实是字段被悄悄删了，只留下你显式写的那几个。
items.$ 和 items.$.name 的本质区别
前者指向“整个子文档”，后者指向“子文档里的某个字段”。Mongoose 更新时必须把路径拆到最细粒度：
-
items.$→ 替换整个数组项（危险） -
items.$.name→ 只改name字段（安全） -
items.$.meta.tags.0→ 改第一个 tag（索引固定，慎用）
常见错误：传入 { name: 'x', price: 99 } 却只写 items.$，结果 stock 字段消失；正确做法是把输入对象扁平成 { 'items.$.name': 'x', 'items.$.price': 99 } 再塞进 $set。
为什么 $[i] 单独写永远不生效
$[i] 不是变量，它只是个占位符，必须配 arrayFilters 才能活。下面这行代码什么都不会做，也不报错：
{$set: {"items.$[i].status": "done"}}
真正起作用的是这三件套同时存在：
- query 条件里有
"items.id": "abc"（定位外层文档） - update 里写
"items.$[i].status"（声明要改哪条路径） - options 里传
{ arrayFilters: [{ "i.id": "abc" }] }（告诉 MongoDB “i 是谁”）
漏掉任意一个，更新就静默跳过——连日志都看不到失败提示。
嵌套太深时最容易被忽略的父级存在性检查
比如想更新 user.profile.skills.$[s].level，如果 user.profile 字段本身是 null 或根本不存在，$[s] 直接失效，不会报错也不会更新。必须在 query 中提前兜底：
{ _id: userId, "profile": { $exists: true, $ne: null }, "profile.skills.id": "js" }
否则哪怕 arrayFilters 写得再准，整个 update 操作也会跳过该文档。这种问题在线上环境极难复现，因为数据不一致往往只发生在部分用户身上。
