如何解决MongoDB注册场景出现E11000 duplicate key重复键错误

错误原因 #

你修改Schema索引配置后没有删除MongoDB集合中已存在的旧索引，旧的唯一约束仍然生效，是导致配置不生效的核心原因。Mongoose默认不会自动覆盖或删除已经创建的历史索引，新的索引配置只会新增，不会替换旧索引。

修复步骤 #

1. 清理旧索引

首先连接到你的MongoDB shell，执行以下命令删除残留的错误索引：

// 切换到你项目使用的数据库
use your_database_name
// 删除accounts集合中除_id默认索引外的所有索引
db.accounts.dropIndexes()

// 如果想精准删除，也可以单独删对应索引：
// db.accounts.dropIndex("phone_1")
// db.accounts.dropIndex("email_1")
// db.accounts.dropIndex("phone_1_email_1")

2. 调整Schema配置

你需求是手机号、邮箱二选一且各自唯一，不需要复合索引，用单字段稀疏唯一索引即可，同时可以增加预保存校验确保至少填写一项：

const schema = new Schema({
    phone: { 
        type: String, 
        unique: true, 
        required: false,
        sparse: true 
    },
    email: { 
        type: String, 
        unique: true, 
        required: false,
        sparse: true 
    },
    // 其余原有字段保持不变
    passwordHash: { type: String, required: true },
    role: { type: String, required: true },
    // ... 其他字段
});

// 新增预保存校验，确保手机号和邮箱至少填一个
schema.pre('save', function(next) {
    if (!this.phone && !this.email) {
        return next(new Error('手机号和邮箱至少需要填写一项'));
    }
    next();
});

3. 确认索引生效

重启项目服务后，在MongoDB shell执行以下命令验证索引配置：

db.accounts.getIndexes()

确认phone和email对应的索引都带有unique: true和sparse: true属性即可。

补充说明 #

你之前配置的phone+email复合唯一索引不符合需求，该约束仅限制二者的组合值唯一，不能保证手机号、邮箱各自全局唯一；partialFilterExpression方案也可以实现需求，但稀疏索引（sparse）对于你的场景更简洁，二者选其一即可，核心前提都是必须先清理旧索引。

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