Skip to content

MongoDB Duplicate 键错误

错误信息

                E11000 duplicate 键错误
              

快速摘要

你 attempted 到 insert document 使用值 那个 violates 唯一索引 in MongoDB — 值 already exists.

为什么发生

  • Inserting document 使用 _id 那个 already exists

  • Inserting duplicate 值 in 字段使用唯一索引

  • race 条件哪里 two inserts happen simultaneously

  • 不检查 for existing documents 之前 inserting

最小示例

✗ 错误代码
db.users.insertOne({ _id: 1, name: 'Ada' });
// A document with _id: 1 already exists → E11000
✓ 修复代码
db.users.updateOne(
  { _id: 1 },
  { $set: { name: 'Ada' } },
  { upsert: true }
);

Using upsert 使用 updateOne 要么更新 existing document or inserts 新 one, avoiding duplicate 键错误.

如何诊断

  • 读取错误到 identify 哪个索引是 violated and duplicate 键值

  • 查询 for existing document: db.集合.findOne({ 字段: 值 })

  • 检查你的唯一索引: db.集合.getIndexes()

如何修复

  • Use 不同值 那个做 不 already exist

  • Use upsert: db.集合.updateOne(筛选, 更新, { upsert: 真 })

  • 检查 for existing document 之前 inserting

  • 移除唯一索引如果 duplicates 应该是 允许

如何预防

  • 检查 for existing documents 之前 inserting

  • Use upsert 模式到 avoid duplicate 键错误

  • Handle E11000 错误 gracefully in 你的 application

相关资源

相关术语

相关课程

← 返回语言