如何在MongoDB文档中定义仅包含唯一值的数组（集合）

嘿，这个需求MongoDB其实提供了非常简洁的解决方案，完全不用自己写额外的判断逻辑来避免重复添加！下面分两种场景给你讲具体实现方法：

一、新增元素时自动去重：使用$addToSet操作符 #

这是最常用也最直接的方式，$addToSet的核心特性就是仅当元素不存在于目标数组中时才执行添加操作，完美匹配你的需求。

单个元素添加示例 #

假设你要更新的文档_id是ObjectId("60d21b4667d0d8992e610c85")，执行以下命令：

db.yourCollection.updateOne(
  { _id: ObjectId("60d21b4667d0d8992e610c85") }, // 匹配目标文档
  { $addToSet: { emails: "jon@gmail.com" } }     // 仅当该邮箱不存在时添加
)

执行后，原数组{"emails":['jon@gmail.com', 'seth@gmail.com']}不会有任何变化，因为jon@gmail.com已经存在。如果添加的是新邮箱（比如lisa@example.com），数组就会更新为['jon@gmail.com', 'seth@gmail.com', 'lisa@example.com']。

批量添加元素示例 #

如果要一次性添加多个元素，还可以结合$each操作符，同样会自动过滤掉重复项：

db.yourCollection.updateOne(
  { _id: ObjectId("60d21b4667d0d8992e610c85") },
  { 
    $addToSet: { 
      emails: { 
        $each: ["jon@gmail.com", "new@example.com", "seth@gmail.com"] 
      } 
    } 
  }
)

执行后，数组只会新增new@example.com，另外两个重复项会被自动忽略。

二、清理已有数组中的重复元素 #

如果你的文档数组已经存在重复值，想要一次性去重，可以使用$setUnion聚合操作符来实现：

db.yourCollection.updateMany(
  {}, // 匹配所有文档，也可以指定特定条件
  [
    { $set: { emails: { $setUnion: ["$emails", []] } } }
  ]
)

$setUnion会返回两个集合的并集，这里用原数组和空数组做并集，本质就是对原数组进行去重，最终得到一个无重复元素的数组。

额外提示 #

• $addToSet是原子操作，在多线程/并发更新的场景下，也能保证不会出现重复添加的问题，MongoDB会自动处理并发冲突。
• 如果你需要更严格的约束（比如确保数组永远不会有重复），可以在业务层配合$addToSet使用，或者在插入文档时就用$setUnion初始化数组。

内容的提问来源于stack exchange，提问作者wprins