MongoDB中如何确保用户文档数组内地址名称唯一？

要实现每个user文档的addresses数组内地址对象的name字段唯一，添加重复名称时触发错误，可通过以下几种方式实现：

方法一：集合级文档验证（MongoDB 3.6+） #

通过MongoDB的文档验证功能，在集合层面强制约束数组内的name字段无重复。

创建带验证规则的集合 #

db.createCollection("users", {
  validator: {
    $expr: {
      // 比较原数组长度与去重后的name数组长度，相等则无重复
      $eq: [
        { $size: "$addresses" },
        { $size: { $setUnion: ["$addresses.name"] } }
      ]
    }
  },
  validationLevel: "strict", // 对所有写入操作生效
  validationAction: "error" // 验证失败时阻止操作并抛出错误
})

为已存在的集合添加验证规则 #

db.runCommand({
  collMod: "users",
  validator: {
    $expr: {
      $eq: [
        { $size: "$addresses" },
        { $size: { $setUnion: ["$addresses.name"] } }
      ]
    }
  },
  validationLevel: "strict",
  validationAction: "error"
})

当尝试插入或更新包含重复addresses.name的文档时，MongoDB会直接抛出验证错误，示例错误信息：

WriteError({
"index" : 0,
"code" : 121,
"errmsg" : "Document failed validation",
"op" : { ... }
})

方法二：更新操作时添加条件判断 #

在执行添加地址的更新操作时，通过查询条件确保目标名称不存在于当前用户的地址列表中：

db.users.updateOne(
  {
    _id: ObjectId("目标用户ID"),
    "addresses.name": { $ne: "待添加的地址名称" }
  },
  {
    $push: {
      addresses: { name: "待添加的地址名称", city: "示例城市", ...其他字段 }
    }
  }
)

执行后检查更新结果的modifiedCount：

• 如果modifiedCount为1，说明地址添加成功；
• 如果modifiedCount为0，说明该名称已存在，此时在应用层触发错误提示即可。

方法三：应用层前置校验 #

在发起数据库操作前，先查询用户的地址列表，提前判断名称是否重复：

// 查询目标用户的地址列表
const targetUser = await db.users.findOne(
  { _id: ObjectId("目标用户ID") },
  { addresses: 1 }
);

// 检查名称是否已存在
const isNameDuplicate = targetUser.addresses.some(addr => addr.name === "待添加的地址名称");

if (isNameDuplicate) {
  // 触发错误提示，比如返回"该地址名称已存在"
} else {
  // 执行添加地址操作
  await db.users.updateOne(
    { _id: ObjectId("目标用户ID") },
    { $push: { addresses: { name: "待添加的地址名称", ...其他字段 } } }
  );
}

⚠️ 注意：这种方法存在竞态风险（同一时间多个请求可能绕过校验），建议结合数据库层面的约束一起使用。

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