Mongoose使用鉴别器首次创建后出现重复键错误问题

嘿，这个问题我之前帮朋友排查过，核心是Mongoose鉴别器和唯一索引的交互踩坑了，结合你的报错信息，我给你拆解下原因和解决办法：

先搞懂为啥会报错 #

你拿到的报错E11000 duplicate key error collection: somedb.base index: name_1 dup key: { : null }，翻译过来就是：

• 你的base集合上有个name字段的唯一索引
• 你创建第二个基础文档时，这个文档的name是null，而MongoDB的普通唯一索引不允许多个文档的该字段为null（这点很容易被忽略）
• 派生文档能正常创建，说明派生Schema要么重写了name字段，要么你的派生文档都会给name赋值，不会出现null的情况

具体解决办法，挑适合你的来 #

办法一：给唯一索引加“稀疏”属性 #

如果你的业务允许name为null，只是不想因为多个null触发重复键错误，直接修改基础Schema的索引设置就行：

const baseSchema = new mongoose.Schema({
  name: {
    type: String,
    unique: true,
    sparse: true, // 关键：稀疏索引只会索引有该字段的文档，null值不会被算进去
    // 要是想更灵活，也可以用partialFilterExpression：
    // partialFilterExpression: { name: { $ne: null } }
  },
  // 其他字段...
});

注意：改完索引后，要么在代码里调用BaseModel.syncIndexes()同步索引，要么手动去MongoDB shell里执行db.base.createIndex({name:1}, {unique: true, sparse: true})，不然旧索引还在的话问题依旧。

办法二：强制基础文档的name字段必填 #

如果name本来就应该是必填项，那直接在Schema里加required: true，从根源避免null值出现：

const baseSchema = new mongoose.Schema({
  name: {
    type: String,
    unique: true,
    required: true // 强制必须传值，再也不会出现null导致的重复键
  },
  // 其他字段...
});

办法三：调整鉴别器的索引继承逻辑 #

Mongoose的鉴别器会默认继承基础Schema的所有索引，但有时候你可能希望派生文档不受这个唯一索引约束，这时候可以在定义鉴别器时显式重写name字段的索引设置：

const derivedSchema = new mongoose.Schema({
  // 你的派生字段...
}, { discriminatorKey: 'type' });

// 移除派生文档的name字段唯一约束（如果不需要的话）
derivedSchema.path('name').index(false);

// 要是派生文档需要自己的唯一规则，也可以单独设置：
// derivedSchema.path('name').index({ unique: true });

const DerivedModel = BaseModel.discriminator('Derived', derivedSchema);

最后验证下 #

改完之后，记得先删掉之前的base集合（或者手动删除旧索引），然后重新跑代码：

• 先创建第一个基础文档，确认成功
• 再创建第二个基础文档，应该就不会报错了
• 最后多创建几个派生文档，确认依然正常运行

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