$addToSet仅对BSON层完全相等的值去重，基础类型正常，对象需字段顺序、结构、类型全一致；重复常因对象字段值或类型差异导致，应标准化为字符串或改用$elemMatch+$push。
$addToSet 不能自动按业务字段去重，它只对 BSON 层「完全相等」的值生效。基础类型（字符串、数字、布尔）能正常去重；对象或数组必须字段名顺序、嵌套结构、数据类型全部一致，才算“相同”。
为什么 $addToSet 插入后数组还是有重复？
常见现象是：两次插入 {uid: 100001, addtime: 123} 和 {uid: 100001, addtime: 456}，结果数组里出现两个对象——因为字段值不同，MongoDB 认为它们不相等。
-
$addToSet对象比较是全字段严格匹配，{a:1,b:2}≠{b:2,a:1} -
NumberInt(1)和1类型不同，也会被判为不同元素 -
null、undefined、缺失字段三者互不相等 - 没报错也不等于成功：查询条件没命中文档，或字段路径写错（比如写成
tags而不是user.tags），$addToSet会静默跳过
怎么让 $addToSet 正确处理对象类元素？
别指望它理解你的业务逻辑。想靠它去重对象，得先把它变成可比的标量形式。
- 把对象转成标准化字符串存为辅助字段，例如：
JSON.stringify(obj, Object.keys(obj).sort())→ 存入tagKey字段，再对tagKey用$addToSet - 改用
$elemMatch+$push组合：先查是否存在{uid: 100001}，不存在再$push - 如果必须保留原始对象字段，确保所有写入都统一类型（全用
NumberInt，不用混用number和string数字）
$addToSet 和 $push + $ne 哪个更靠谱？
对简单值（如字符串标签、用户 ID），$addToSet 足够；但涉及对象或高并发场景，$push + $ne 更可控。
-
$push+$ne是原子操作，避免了$addToSet内部遍历判断的竞态风险 -
$addToSet时间复杂度是 O(n)，数组超几百项时写入延迟明显上升 - 多键索引对
$addToSet的去重过程无加速作用，仅优化查询 - 真正强一致性需求，建议加唯一复合索引（如
{userId: 1, tag: 1}）+$push+ 捕获11001 duplicate key错误兜底
实际调试时最容易漏掉的检查点
多数“重复没去成”问题，根本不在 $addToSet 逻辑本身，而在外围配置。
- 用
find()先确认 update 查询条件是否真能定位到目标文档 - 核对字段路径：是
profile.skills还是skills？拼错一个点就失效 - 确认字段当前确实是数组类型——如果原字段是字符串，
$addToSet直接报错"cannot apply $addToSet to non-array field" - MongoDB 4.2+ 才支持
$addToSet与聚合表达式结合（如$set+$cond），旧版本抄新写法会失败
真正难处理的不是语法，而是你默认“对象内容一样就该去重”这个假设——MongoDB 不认这个理。得提前把业务语义映射成它能比的格式，或者换更确定的控制方式。
