解决 Node.js 中使用 Mongoose 操作 MongoDB 时出现的 “MongoError: E11000 duplicate key error”

阅读时长 7 分钟读完

问题描述

在使用 Node.js 中的 Mongoose 操作 MongoDB 数据库时,有时会出现如下错误:

这个错误通常是由于在数据库中已经存在重复的键值造成的。这个问题在实际开发中非常常见,需要我们对其进行解决。

解决方案

1. 添加唯一索引

在 MongoDB 中,我们可以通过添加唯一索引来防止重复键值的插入。在 Mongoose 中,可以通过在 Schema 中设置 unique 属性为 true 来创建唯一索引。例如:

这样,当我们尝试插入重复的 usernameemail 时,就会出现上述错误。但是,这种方法只适用于我们确定要将哪些字段设置为唯一索引的情况。如果我们无法确定要设置哪些字段为唯一索引,那么就需要使用下面的方法。

2. 捕获错误并处理

在 Mongoose 中,我们可以通过捕获错误并处理来解决这个问题。当我们尝试插入重复的数据时,Mongoose 会抛出一个 MongoError 异常,我们可以通过 try...catch 语句来捕获这个异常,并在捕获到异常时进行处理。例如:

-- -------------------- ---- -------
--- -
  ----- ------------
- ----- ------- -
  -- ------ ---------- -------------- -- ---------- --- ------ -
    -- ---------
  - ---- -
    -- ---------
  -
-

在上述代码中,我们使用了 try...catch 语句来捕获异常,并使用 instanceof 运算符来判断异常类型是否为 mongoose.Error。如果是,我们就可以通过 error.code 属性来判断错误码是否为 11000,如果是,就说明出现了重复键值的情况,我们可以在这里进行处理。

3. 自定义错误处理中间件

如果我们不想在每个操作中都使用 try...catch 语句来处理异常,我们可以使用 Mongoose 的中间件机制来自定义一个错误处理中间件。例如:

在上述代码中,我们使用了 userSchema.post() 方法来为 save 事件添加一个中间件,当保存操作出现异常时,会触发这个中间件。在中间件中,我们可以通过判断异常名称和错误码来处理重复键值的情况。

示例代码

下面是一个完整的示例代码,用于演示如何在 Mongoose 中解决重复键值的问题:

-- -------------------- ---- -------
----- -------- - --------------------

-------------------------------------------- - ---------------- ----- ------------------- ---- --
  -------- -- ---------------------- -- -------------
  ---------- -- -------------------- --- ------- -- ------------ ------

----- ---------- - --- -----------------
  --------- - ----- ------- --------- ----- ------- ---- --
  --------- - ----- ------- --------- ---- --
  ------ - ----- ------- --------- ----- ------- ---- --
---

----------------------- --------------- ---- ----- -
  -- ----------- --- ------------ -- ---------- --- ------ -
    ------------------------ --- -------- ---------------
  - ---- -
    ----------------------- ---------------
  -
  -------
---

----- ---- - ---------------------- ------------

----- -------- -------------------- --------- ------ -
  ----- ---- - --- ------ --------- --------- ----- ---
  --- -
    ----- ------------
    ----------------- ---------- ------
  - ----- ------- -
    -------------------- --- ------ ------- ---------------
  -
-

------------------ ----------- --------------------
------------------ ----------- --------------------
------------------ ----------- --------------------

在上述代码中,我们定义了一个 User 模型,使用了 unique 属性来设置唯一索引,使用了自定义错误处理中间件来处理重复键值的情况。最后,我们创建了三个用户,其中第二个用户的邮箱和第一个用户重复,会触发重复键值的错误。运行这个代码,我们可以看到如下输出:

可以看到,第二个用户的创建失败了,出现了重复键值的错误。同时,我们也可以看到我们的自定义错误处理中间件成功地捕获了这个错误,并输出了相应的错误信息。

结论

在 Node.js 中使用 Mongoose 操作 MongoDB 时,出现重复键值的错误是非常常见的问题。我们可以通过添加唯一索引、捕获错误并处理、自定义错误处理中间件等方式来解决这个问题。在实际开发中,我们需要根据具体情况选择合适的解决方案,以确保我们的应用程序的稳定性和可靠性。

来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6764d6f3856ee0c1d42ecb16

纠错
反馈