MongoDB子文档数组联合唯一索引不生效问题求助

背景 #

我有一个名为estates的集合，已经为name字段创建了唯一索引，语句如下：

db.estates.createIndex ({ "name": 1 }, { unique: true })

这个索引工作正常——插入重复name的文档会直接触发错误。

我想实现同一个estate下，buildings子文档数组里的name不能重复，于是创建了复合唯一索引：

db.estates.createIndex ({ "name": 1, "buildings.name": 1 }, { unique: true })

但这个索引完全没起作用：在name为'Estate 1'的文档里，buildings数组里可以同时存在多个name: 'Building 1'的条目，示例文档如下：

{
  _id: ObjectId('6661f5ec5236ce287fa26a17'),
  name: 'Estate 1',
  code: '12345',
  buildings: [
    { name: 'Building 3' },
    {
      name: 'Building 4',
      code: '4444',
      function: '',
      floor_area: '',
      number_of_floors: '',
      _id: ObjectId('66673d5ae5d0c8f632280614')
    },
    {
      name: 'All buildings',
      _id: ObjectId('66ae5a9fc029cb808ff01784')
    },
    {
      name: 'Building 2',
      code: '222222',
      function: '',
      floor_area: '',
      number_of_floors: '',
      _id: ObjectId('66afaaee36c6939cbbe20611')
    },
    {
      name: 'Building 1',
      code: '',
      function: '',
      floor_area: '',
      number_of_floors: '',
      _id: ObjectId('6739f3d0858859fdada218ea')
    },
    {
      name: 'Building 1',
      code: '',
      function: '',
      floor_area: '',
      number_of_floors: '',
      _id: ObjectId('6739f3e3858859fdada218eb')
    }
  ],
  building_systems: [
    {
      name: 'VS01',
      category: 'Heating - radiator',
      building: 'Building one',
      room: '4320',
      floor: '04',
      control_cabinet: 'AS01',
      year: 2008,
      components: [
        { name: 'P1', category: 'Pump - circulation' },
        { name: 'ST21', category: 'Actuator - valve' }
      ]
    },
    {
      _id: ObjectId('6661f5ec5236ce287fa26a15'),
      name: 'VV01',
      category: 'Hot water',
      building: 'Building one',
      room: '4320',
      floor: '04',
      year: 2008
    },
    { name: 'LB01', _id: ObjectId('66675021e5d0c8f632280615') }
  ],
  control_cabinets: [
    {
      _id: ObjectId('6661f5ec5236ce287fa26a16'),
      name: 'AS01',
      building: 'Building one',
      room: '4320',
      floor: '04',
      year: 2008,
      plc_manufacturer: 'Beckhoff',
      ip_address: '198.192.0.28',
      port: 183,
      protocol: 'ADSL'
    },
    { name: 'AS02', _id: ObjectId('66675442e5d0c8f632280618') }
  ]
}

你忽略的关键点 #

MongoDB的复合唯一索引包含数组字段时，约束逻辑是跨文档的，而非文档内数组元素的：

• 这个索引会阻止「两个不同的estate文档，拥有相同的name且各自包含一个buildings.name相同的条目」这种情况，但完全不会限制同一个文档内数组里的重复元素。
• 原因是MongoDB会为数组中的每个元素单独生成索引条目，但这些条目都关联同一个文档的_id，唯一索引不会将同一文档下的重复数组元素判定为违规。

解决方案 #

要实现「同一个estate下buildings.name唯一」，可以用以下两种可靠方式：

方式1：文档级验证（推荐） #

给集合添加验证规则，强制检查buildings.name数组内无重复值：

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

原理是比较buildings.name数组的原始长度和去重后的长度，若不一致则判定为违规，直接阻止写入/更新。

方式2：应用层+数组过滤器校验 #

如果无法修改集合验证规则，可以在更新时用数组过滤器确保不插入重复值：

// 向指定estate添加新building时，先检查是否已存在同名条目
db.estates.updateOne(
  { name: "Estate 1" },
  { $push: { buildings: { name: "Building 1" } } },
  {
    arrayFilters: [
      { "newBuilding.name": { $nin: "$buildings.name" } }
    ]
  }
)

这种方式需要在应用代码里处理校验逻辑，不如文档验证稳定。

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