Mongoose中unique校验失效求助：User模型无法限制重复值

核心原因 #

Mongoose的unique选项本质是告知MongoDB为对应字段创建唯一索引，若索引未成功生成，唯一性校验就会失效。你的Student模型能正常生效，大概率是因为集合创建时索引成功建立，而User模型的索引未正确生成。

具体修复步骤 #

1. 补全依赖导入（顺带修复邮箱格式校验） #

你的User模型中使用了validator.isEmail但未导入validator包，先补上：

import { Schema, model } from 'mongoose';
import { User } from './user.interface';
import validator from 'validator'; // 补充此行导入

2. 手动重建MongoDB唯一索引 #

若User集合已存在，修改Schema后Mongoose不会自动更新索引，需手动操作：

• 代码同步方式：在数据库连接成功后添加索引同步逻辑

import mongoose from 'mongoose';

mongoose.connect('你的数据库连接字符串')
  .then(async () => {
    console.log('数据库连接成功');
    // 同步User模型的所有索引
    const { UserModel } = await import('./path/to/user.model');
    await UserModel.syncIndexes();
    console.log('User模型索引同步完成');
  })
  .catch(err => console.error('连接失败', err));

• MongoDB Shell方式：直接在Shell中创建索引

# 为id字段创建唯一索引
db.users.createIndex({ id: 1 }, { unique: true })
# 为username字段创建唯一索引
db.users.createIndex({ username: 1 }, { unique: true })
# 为email字段创建唯一索引
db.users.createIndex({ email: 1 }, { unique: true })

注意：若集合中已有重复数据，创建索引会失败，需先删除重复数据再执行。

3. 检查数据库连接配置 #

确保Mongoose连接时开启自动索引（开发环境默认开启，生产环境建议手动控制）：

mongoose.connect('你的数据库连接字符串', {
  autoIndex: process.env.NODE_ENV !== 'production' // 开发环境自动建索引，生产环境关闭
})

4. 验证索引是否创建成功 #

在MongoDB Shell中执行以下命令，查看User集合的索引列表：

db.users.getIndexes()

输出结果中应能看到id、username、email对应的unique: true索引项。

额外优化：捕获重复键错误 #

唯一性校验最终由MongoDB索引保证，并发写入场景下Mongoose前置检查可能失效，建议在代码中捕获E11000重复键错误，返回友好提示：

try {
  const newUser = await UserModel.create(userData);
} catch (err) {
  if (err.code === 11000) {
    const duplicateField = Object.keys(err.keyPattern)[0];
    throw new Error(`${duplicateField}已存在，请更换`);
  }
  throw err;
}

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