Mongoose经常返回e11000 error的原因分析

下面是详细讲解“Mongoose经常返回e11000 error的原因分析”的完整攻略。

什么是 Mongoose 的 E11000 错误？

当使用 Mongoose 进行数据库操作，如插入文档时，如果违反了唯一索引的约束条件，Mongoose 会返回一个 E11000 错误。具体的错误消息通常是这样的：

{ MongoError: E11000 duplicate key error collection: mycollection index: myindex_1 dup key: { : "duplicate-value" } }

上面的示例中，mycollection 是集合名称，myindex_1 是索引名称，"duplicate-value" 是重复的值。

Mongoose 返回 E11000 错误的原因分析

Mongoose 返回 E11000 错误的原因通常有两种：唯一索引冲突和错误的 Schema 配置。

唯一索引冲突

如果在某个字段上定义了唯一索引，那么该字段的值不能重复，否则会触发 E11000 错误。

例如，我们有一个 User 文档模型，其中 email 字段是唯一索引：

const userSchema = new Schema({
  username: { type: String },
  email: { type: String, unique: true },
  password: { type: String },
});
const User = mongoose.model("User", userSchema);

如果我们插入两个 email 字段相同的文档，就会触发 E11000 错误：

const user1 = new User({ username: "harry", email: "[e-mail]", password: "123456" });
const user2 = new User({ username: "ron", email: "[e-mail]", password: "123456" });
Promise.all([user1.save(), user2.save()]).catch((error) => console.error(error));

会报错类似于：

{ MongoError: E11000 duplicate key error collection: test.users index: email_1 dup key: { : "[e-mail]" } }

错误的 Schema 配置

如果 Schema 中的字段配置错误，也有可能触发 E11000 错误。

例如，我们有一个 Book 文档模型，其中 title 和 author 字段都是必填字段：

const bookSchema = new Schema({
  title: { type: String, required: true, unique: true },
  author: { type: String, required: true },
  price: { type: Number },
});
const Book = mongoose.model("Book", bookSchema);

可以看到，title 字段配置了 unique: true，但 title 字段还是必填字段，这意味着无法插入没有 title 值的文档。这种情况下，如果我们插入一条没有 title 值的文档，就会触发 E11000 错误：

const book = new Book({ author: "JK Rowling", price: 20 });
book.save().catch((error) => console.error(error));

错误信息类似于：

{ MongoError: E11000 duplicate key error collection: test.books index: title_1 dup key: { : null } }

总结

如果你经常在使用 Mongoose 中遇到 E11000 的错误，可能是唯一索引冲突或者是 Schema 配置错误导致的。在使用 Mongoose 插入文档时，务必关注 E11000 错误。当出现该错误时，应该检查出现错误的文档，找到重复的字段，然后检查字段是否在 Schema 中定义了唯一索引，或者是否有其他配置错误导致了错误。