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 → E11000db.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
相关资源
相关课程
- MongoDB 基础
学习关于 MongoDB 索引 and uniqueness.