MongoDB出现E11000重复键错误如何解决？

1. 先排查集合索引问题 #

首先确认你的Product集合是否存在多余的唯一索引，运行MongoDB命令查看当前索引：

db.products.getIndexes()

如果发现name或其他非_id字段带有唯一约束，而业务不需要该约束，可执行命令删除对应索引（替换成实际索引名）：

db.products.dropIndex("name_1")

2. 修正_id字段的处理逻辑 #

你在Schema中手动定义了_id字段，但创建新商品时未生成唯一ObjectId，导致Mongoose无法自动填充该字段，进而引发重复键问题。有两种解决方式：

方式一：移除手动定义的_id #

Mongoose默认会自动为每个文档生成唯一_id，无需手动声明。修改Schema：

const productSchema = mongoose.Schema(
  {
    // 移除这一行：_id: mongoose.Schema.Types.ObjectId,
    name: {
      type: String,
      required: true,
      default: '',
    },
    // 其余字段保持不变
  },
  {
    timestamps: true,
    id: false,
    toJSON: { virtuals: true },
  }
);

方式二：创建商品时手动生成_id #

若确实需要手动控制_id，则在创建新商品时必须生成新的ObjectId：

const newProduct = {
  _id: new mongoose.Types.ObjectId(), // 添加该行生成唯一ID
  name: request.body.name,
  description: request.body.description,
  price: request.body.price,
  category: request.body.category,
};

3. 修复并发场景下的竞态问题 #

你的代码先查询同名商品再创建，但高并发时可能出现两个请求同时通过查询、同时创建同名商品的情况，触发唯一索引错误。可以通过Schema层面给name加唯一约束，让数据库兜底保证唯一性，同时保留代码查询返回友好提示：

修改Schema的name字段：

name: {
  type: String,
  required: true,
  default: '',
  unique: true, // 添加唯一约束
},

同时在错误捕获逻辑中针对性处理重复键错误：

catch (error) {
  if (error.code === 11000) {
    return response.status(400).send({ message: 'Product with this name already exists' });
  }
  console.log(error.message);
  response.status(500).send({ message: error.message });
}

4. 清理现有重复数据 #

若集合中已存在重复的_id或name数据，需先删除重复项才能彻底解决问题：

// 示例：删除重复name的文档，仅保留第一个
db.products.aggregate([
  { $group: { _id: "$name", duplicates: { $push: "$_id" }, count: { $sum: 1 } } },
  { $match: { count: { $gt: 1 } } }
]).forEach(doc => {
  doc.duplicates.shift(); // 保留第一个文档
  db.products.deleteMany({ _id: { $in: doc.duplicates } });
});

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