直接用点号路径更新嵌套对象字段无需$操作符，仅数组才需$；更新数组元素必须配合查询条件定位；多层嵌套数组须用arrayfilters；避免用$set整体替换对象导致字段丢失。
直接用点号路径更新嵌套对象字段
只要嵌套字段是普通结构体（不是数组），就完全不需要 $ 操作符。比如文档里有 ck_details.leadId，你想改它，直接写 "ck_details.leadId" 就行。
常见错误是看到“嵌套”就下意识加 $.leadId 或 ck_details.$.leadId——这会报错，因为 $ 只对数组有效，而你这里根本没有数组。
- ✅ 正确：
"ck_details.appId"、"address.city"、"emails.received" - ❌ 错误：
"ck_details.$.appId"、"address.$.city"、"emails.$.received" - 如果字段不存在，
$set会自动创建它；如果存在，只改该字段，其他同级字段（如ck_details.refNum）不受影响
更新数组中某个元素的字段必须配查询条件
当你要改的是数组里的某一项（比如 emails 是 []Emails），就必须让 MongoDB 知道“改哪一个”。$ 不是万能定位符，它只在查询条件已锁定具体数组项时才生效。
错误写法：{"email": "a@b.com"} 查询 + "emails.$.received" 更新 → 报错 The positional operator did not find the match needed from the query。
- ✅ 必须在查询里带上数组匹配项，例如：
"emails._id": bson.ObjectIdHex("...")或"emails.name": "work" - 更新语句才能用
"emails.$.received"，此时$才指向那个被查到的数组元素 - 如果数组字段名拼错（比如写成
emailss），或查询没命中任何数组项，$同样失效
多层嵌套数组更新得用 arrayFilters
像 user.profile.skills[].level 这种结构，光靠 $ 不够——它只能定位第一层数组。要精确更新 skills 数组里满足条件的某一项的 level，必须用 arrayFilters。
$[s] 不是变量，只是占位符；不传 arrayFilters，它就什么都不干，还不会报错，更新静默失败。
- ✅ 路径必须完整：
"user.profile.skills.$[s].level"，不能漏掉user.或profile. -
arrayFilters是 update 方法的第三个参数（options），内容是数组，例如：[{"s.name": "MongoDB"}] -
s必须和$[s]里的一致，大小写敏感；一个arrayFilters里只能定义一个 identifier - 如果
user.profile字段本身不存在，$[s]直接跳过，不更新也不报错
别用 $set 整体替换嵌套对象
写 $set: { "ck_details": { "appId": "x" } } 看似省事，实际会把整个 ck_details 对象替换成新对象，丢掉原有字段（如 leadId、refNum）。
这不是 bug，是 $set 的设计行为：作用于对象字段时，就是全量替换。
- ✅ 想追加或修改单个字段，永远用点号路径：
"ck_details.appId" - ❌ 别试图用
$push更新对象字段——$push只对数组有效，对对象会报错 - 如果真需要动态构造嵌套路径（比如字段名来自变量），要用
bson.M动态拼 key，而不是硬编码整个对象
[]Emails 和一个 Emails 看起来只差一对括号，却直接决定该用点号还是 $。
