Mongoose Schema数组内字段唯一验证首次运行未触发重复键错误的原因咨询

为什么首次运行未报错？ #

这背后的核心原因是Mongoose创建索引的异步特性：

• 当你首次运行代码时，目标集合exampledb.testusers还不存在。Mongoose会先帮你创建集合，然后在后台异步地构建你定义的唯一索引。
• 而你执行的await User.create(fakes)操作，是在索引完全构建完成之前就完成了写入。此时MongoDB的唯一索引还未生效，所以即使你插入了50个包含重复skills.name（"JavaScript"和"CSS"）的文档，也不会触发重复键错误。

等首次运行完成后，索引才会在后台构建完毕，这就导致第二次运行时，索引已经生效，写入重复值就会被拦截。

集合存在与否时，Mongoose唯一验证的差异 #

这里要区分Mongoose的Schema层面验证和MongoDB的数据库级唯一索引：

• 集合不存在的场景

  • Mongoose会自动创建集合，同时触发索引的创建，但这个索引创建过程是异步后台执行的。
  • 在索引构建完成前，所有写入操作只会经过Mongoose的Schema层面验证（比如required规则），但不会受到MongoDB唯一索引的约束——因为索引还没生效。
  • 这就导致你首次插入重复值时，数据库层面没拦截，所以没报错。

• 集合已存在的场景

  • 如果是第二次运行，集合和对应的唯一索引已经存在，此时所有写入操作会直接受到MongoDB唯一索引的约束。
  • 哪怕你是重新运行相同的写入代码，只要索引已经生效，重复的skills.name就会触发duplicate key error。

额外建议：你的需求可能用错了唯一约束 #

从代码来看，你大概率想实现的是单个用户的skills数组内name不重复，但你设置的unique: true是全局唯一（即所有用户的skills.name都不能重复），这显然不符合常见业务逻辑。

如果你要实现单个用户内skills.name唯一，推荐两种方式：

1. 使用MongoDB的$addToSet操作来添加技能，避免重复插入；
2. 给Mongoose Schema添加自定义验证器，在保存前检查当前用户的skills数组内是否已有同名技能：

   const schema = new Schema({
     username: String,
     skills: [new Schema({
       _id: false,
       name: { type: String, required },
       level: { type: Number, default: 0 }
     })]
   });
   
   schema.path('skills').validate(function(value) {
     const names = value.map(skill => skill.name);
     return new Set(names).size === names.length;
   }, 'Skills must have unique names');
   

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