MongoDB插入新文档触发E11000重复键错误的问题求助

核心原因 #

你给数组子文档中的xxx_xx字段设置了unique: true，但MongoDB的唯一索引在处理数组类型字段时，会将数组内的每个元素单独纳入唯一性校验范围。同时你给该字段设置了默认值""，当插入多个文档时，每个文档的数组元素里xxx_xx都是空字符串，这就触发了重复键错误。另外，若字段未赋值且无默认值，MongoDB会存null，多个null同样会被判定为重复。

解决方案 #

场景1：仅需同一个文档的数组内xxx_xx唯一 #

如果不需要全局所有文档的数组元素都唯一，只是要避免单文档数组内出现重复值，移除unique: true，改用Mongoose自定义验证器：

xxxxxx: [
  {
    xxx_xx: {
      type: String,
      default: "",
      validate: {
        validator: function(value) {
          // 遍历当前数组，检查是否有重复的xxx_xx值
          const valueList = this.xxxxxx.map(item => item.xxx_xx);
          return valueList.indexOf(value) === valueList.lastIndexOf(value);
        },
        message: props => `数组内已存在值 ${props.value}，不可重复`
      }
    },
    xxxxxx: {
      type: Schema.Types.ObjectId,
      ref: "anotherSchema"
    }
  }
]

场景2：需要全局所有文档的数组元素xxx_xx唯一 #

若必须保证该字段全局唯一，不能使用空字符串这类重复率高的默认值，改为生成全局唯一的默认值，比如用UUID：

const { v4: uuidv4 } = require('uuid');

// 定义Schema时
xxxxxx: [
  {
    xxx_xx: {
      type: String,
      default: uuidv4, // 自动生成唯一UUID作为默认值
      unique: true
    },
    xxxxxx: {
      type: Schema.Types.ObjectId,
      ref: "anotherSchema"
    }
  }
]

同时要确保插入新文档时，手动指定的xxx_xx值也都是全局唯一的。

清理残留索引 #

如果之前已经创建了错误的唯一索引，即使修改了Schema，残留的索引仍会导致错误。需要手动删除该索引：

• 打开MongoDB Compass，找到目标集合mycollection
• 切换到Indexes标签页
• 找到名为xxxxxx.xxxxxx_xx_1的索引，点击删除按钮

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