Passport Local Mongoose报11000重复键错误，求排查修复方案

问题背景 #

我搭建了一个简易用户注册应用，User模型代码如下：

const mongoose = require('mongoose');
const passportLocalMongoose = require('passport-local-mongoose')
const { Schema } = mongoose;

const userSchema = new Schema({
  email: {
    type: String,
  },
  phoneNumber: {
    type: String
  },
  firstName: {
    type: String
  },
  lastName: {
    type: String
  },
  password: {
    type: String
  },
  googleId: {
    type: String
  },
  facebookId: {
    type: String
  },
  avatar: {
    type: String
  },
  role: {
    type: String,
    default: 'Member',
    enum: ['Admin', 'Member', 'Merchant']
  },
  resetPasswordToken: { type: String },
  resetPasswordExpires: { type: Date },
},{
  timestamps: true
}));

userSchema.plugin(passportLocalMongoose, {usernameField: 'email', usernameQueryFields:['email']});

module.exports = mongoose.model('User', userSchema);

首次提交数据时成功，但第二次提交时出现如下错误：

{
    "index": 0,
    "code": 11000,
    "keyPattern": {
        "username": 1
    },
    "keyValue": {
        "username": null
    }
}

错误原因分析 #

这个11000错误是MongoDB的唯一索引冲突错误，根源在于：

1. passport-local-mongoose插件默认会为username字段创建唯一索引，虽然你配置了usernameField: 'email'把用户名映射到邮箱字段，但第一次创建模型时，你没有给email字段添加必填约束，导致提交空邮箱时，插件会把username字段设为null。
2. MongoDB的唯一索引中，null值只能存在一条记录，所以第二次提交空邮箱时，就会触发username: null的重复键冲突。
3. 额外问题：你在Schema中手动定义了password字段，但passport-local-mongoose会自动生成hash和salt字段来存储加密后的密码，手动定义的password字段是冗余的，甚至可能干扰插件的密码处理逻辑。

修复步骤 #

1. 修正User Schema的email字段 #

给email字段添加必填、唯一约束，确保提交的邮箱合法且不重复，同时格式化邮箱（转小写、去空格）：

email: {
  type: String,
  required: [true, "邮箱不能为空"],
  unique: true,
  trim: true,
  lowercase: true
},

同时删除Schema中手动定义的password字段，让插件自动处理密码存储：

// 移除这一行冗余代码
password: {
  type: String
},

2. 清理MongoDB中已存在的错误索引 #

因为第一次创建模型时，插件已经自动创建了username字段的唯一索引，现在需要删除这个索引，避免继续触发冲突：
打开MongoDB Shell，执行以下命令：

# 切换到你的应用数据库
use your_database_name
# 删除username字段的唯一索引
db.users.dropIndex("username_1")

（注：users是模型对应的默认集合名，如果你修改过模型的集合名称，请替换为实际名称）

3. 重启应用并重新测试 #

修改完Schema并清理索引后，重启Node.js应用，再次测试注册功能：

• 提交合法邮箱的用户数据，应该能正常创建
• 如果提交空邮箱，Mongoose会先触发必填验证，不会进入MongoDB层面的索引冲突

额外注意事项 #

• 如果你已经有存在的null邮箱的用户记录，需要先删除该记录，否则即使添加了必填约束，仍然可能触发索引冲突
• passport-local-mongoose的usernameQueryFields配置已经指定了用邮箱查询，无需额外处理查询逻辑

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