Mongoose 是一个 Node.js 的 MongoDB 驱动程序，它提供了一种对象文档映射 (Object Document Mapping，简称 ODM) 的方式来操作数据库。但是，在使用 Mongoose 过程中，我们常常会遇到各种错误，这些错误可能会让我们感到困惑和无助。本文将介绍 Mongoose 中常见的 20 个错误及解决方法，帮助大家更好地使用 Mongoose。
1. 连接错误
错误信息
MongooseError: Failed to connect to mongodb://localhost:27017/myapp
解决方法
检查 MongoDB 是否已经启动，检查连接字符串是否正确，检查数据库是否存在。
const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/myapp', { useNewUrlParser: true })
.then(() => console.log('Connected to MongoDB...'))
.catch(err => console.error('Could not connect to MongoDB...', err));2. 模型定义错误
错误信息
TypeError: Cannot read property 'Schema' of undefined
解决方法
检查是否正确导入了 mongoose 模块。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- --------- ------ --- ----- ---- - ---------------------- ------------
3. 模型名称错误
错误信息
MongooseError: Cannot overwrite `User` model once compiled.
解决方法
检查是否有重复定义模型，或者模型名称是否与其他模型名称冲突。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- --------- ------ --- ----- ---- - -------------------- -- ---------------------- ------------
4. 数据库操作错误
错误信息
MongooseError: Operation `users.insertOne()` buffering timed out after 10000ms
解决方法
检查 MongoDB 是否正常运行，或者是否有足够的磁盘空间。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
----- -------
------ -------
--------- ------
---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
----- ----- -----
------ -----------------------
--------- --------
---
----- ------------
-
-------------5. 查询错误
错误信息
MongooseError: Query was already executed: User.findOne({ name: 'John Doe' }).limit(1)解决方法
检查是否重复执行查询操作。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- --------- ------ --- ----- ---- - ---------------------- ------------ ----- -------- ---------- - ----- ---- - ----- -------------- ----- ----- ---- ------------ ------------------ - -----------
6. 更新错误
错误信息
MongooseError: Can't update a document that hasn't been loaded
解决方法
检查是否先加载了文档再更新。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- --------- ------ --- ----- ---- - ---------------------- ------------ ----- -------- -------------- ----- - ----- ---- - ----- ------------------ -- ------- ------- --------- - ----- ----- ------------ - -------------------- ----- ------
7. 删除错误
错误信息
MongooseError: Can't remove() a document that hasn't been loaded
解决方法
检查是否先加载了文档再删除。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- --------- ------ --- ----- ---- - ---------------------- ------------ ----- -------- -------------- - ----- ---- - ----- ------------------ -- ------- ------- ----- -------------- - ---------------------
8. 验证错误
错误信息
ValidationError: User validation failed: name: Path `name` is required.
解决方法
检查是否设置了必填字段。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
----- -
----- -------
--------- ----
--
------ -------
--------- ------
---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
------ -----------------------
--------- --------
---
--- -
----- ----------------
- ----- ---- -
--------------------------
-
-
-------------9. 自定义验证错误
错误信息
ValidationError: User validation failed: email: Invalid email address
解决方法
添加自定义验证器。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
----- -------
------ -
----- -------
--------- -
---------- ----------- -
------ -----------------------
--
-------- ----- -- --------------- -- --- - ----- ----- --------
-
--
--------- ------
---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
----- ----- -----
------ -----------
--------- --------
---
--- -
----- ----------------
- ----- ---- -
--------------------------
-
-
-------------10. 聚合错误
错误信息
MongooseError: Can't use $lookup stage in pipeline without preceding stages
解决方法
检查聚合管道中是否有前置阶段。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ----------- - --- --------
--------- -
----- ----------------------
---- ----------
--
------ --
-------- -
----- ----------------------
---- ---------
--
--------- ------
--
---
----- ----- - ----------------------- -------------
----- -------- ----------- -
----- ------ - ----- -----------------
-
-------- -
----- ------------
----------- -----------
------------- ------
--- ----------
-
-
---
--------------------
-
------------11. 索引错误
错误信息
MongoError: E11000 duplicate key error collection: myapp.users index: email_1 dup key: { : "john.doe@example.com" }解决方法
检查是否有重复的索引值。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
----- -------
------ -
----- -------
------- ----
--
--------- ------
---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
----- ----- -----
------ -----------------------
--------- --------
---
--- -
----- ------------
- ----- ---- -
--------------------------
-
-
-------------12. 外键错误
错误信息
ValidationError: Order validation failed: customer: Cast to ObjectId failed for value "123456" at path "customer"
解决方法
检查外键是否正确设置。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- -------------- - --- --------
----- -------
------ ------
---
----- -------- - -------------------------- ----------------
----- ------------- - --- --------
----- -------
------ ------
---
----- ------- - ------------------------- ---------------
----- ----------- - --- --------
--------- -
----- ----------------------
---- ----------
--
------ --
-------- -
----- ----------------------
---- ---------
--
--------- ------
--
---
----- ----- - ----------------------- -------------
----- -------- ------------- -
----- -------- - --- ----------
----- ----- -----
------ ----------------------
---
----- ----------------
----- ------- - --- ---------
----- --------
------ ----
---
----- ---------------
----- ----- - --- -------
--------- -------------
------ --
-------- ------------
--------- -
--
---
--- -
----- -----------------
----- -------------
- ----- ---- -
--------------------------
-
-
--------------13. 虚拟属性错误
错误信息
TypeError: Cannot read property 'length' of undefined
解决方法
检查虚拟属性是否正确设置。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
---------- -------
--------- ------
---
--------------------------------------------- -
------ ------------------ ------------------
---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
---------- -------
--------- -----
---
---------------------------
-
-------------14. 联合索引错误
错误信息
MongoError: E11000 duplicate key error collection: myapp.users index: email_1_name_1 dup key: { : "john.doe@example.com", : null }解决方法
检查联合索引是否正确设置。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
----- -------
------ ------
---
------------------ ------ -- ----- - -- - ------- ---- ---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
----- ----- -----
------ ----------------------
---
--- -
----- ------------
- ----- ---- -
--------------------------
-
-
-------------15. 联合查询错误
错误信息
MongooseError: Cannot call `populate()` on a non-existent field "customer"
解决方法
检查联合查询的字段是否正确设置。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- -------------- - --- --------
----- -------
------ ------
---
----- -------- - -------------------------- ----------------
----- ------------- - --- --------
----- -------
------ ------
---
----- ------- - ------------------------- ---------------
----- ----------- - --- --------
--------- -
----- ----------------------
---- ----------
--
------ --
-------- -
----- ----------------------
---- ---------
--
--------- ------
--
---
----- ----- - ----------------------- -------------
----- -------- ----------- -
----- ------ - ----- ------------------------------------------------------------
--------------------
-
------------16. 日期错误
错误信息
ValidationError: User validation failed: dob: Cast to Date failed for value "1980-01-01" at path "dob"
解决方法
检查日期格式是否正确。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ---------- - --- --------
----- -------
---- ----
---
----- ---- - ---------------------- ------------
----- -------- ------------ -
----- ---- - --- ------
----- ----- -----
---- ------------
---
--- -
----- ----------------
- ----- ---- -
--------------------------
-
-
-------------17. 联合更新错误
错误信息
MongooseError: Operation `users.updateOne()` buffering timed out after 10000ms
解决方法
检查联合更新条件是否正确。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- ---- ------ --- ----- ---- - ---------------------- ------------ ----- -------- ------------- - ----- ------ - ----- ----------------- ---- - ---- -- - -- - ----- - ----- ----- ---- - --- -------------------- - --------------
18. 嵌套文档错误
错误信息
ValidationError: Order validation failed: items.0.quantity: Path `quantity` is required.
解决方法
检查嵌套文档是否正确设置必填字段。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- ----------- - --- --------
--------- -
----- ----------------------
---- ----------
--
------ --
-------- -
----- ----------------------
---- ---------
--
--------- -
----- -------
--------- ----
-
--
---
----- ----- - ----------------------- -------------
----- -------- ------------- -
----- ----- - --- -------
--------- ---------
------ --
-------- -------
--------- -
--
---
--- -
----- -----------------
----- -------------
- ----- ---- -
--------------------------
-
-
--------------19. 数组操作错误
错误信息
MongooseError: Operation `users.updateOne()` buffering timed out after 10000ms
解决方法
检查数组操作条件是否正确。
-- -------------------- ---- ------- ----- -------- - -------------------- ----- ------ - ---------------- ----- ---------- - --- -------- ----- ------- ------ ------- ----- -------- --- ----- ---- - ---------------------- ------------ ----- -------- ------------- - ----- ------ - ----- ----------------- ----- - ---- --------- ------------ - -- - ------ - ----- ------- - --- -------------------- - --------------
20. 联合删除错误
错误信息
MongooseError: Operation `customers.deleteOne()` buffering timed out after 10000ms
解决方法
检查联合删除条件是否正确。
-- -------------------- ---- -------
----- -------- - --------------------
----- ------ - ----------------
----- -------------- - --- --------
----- -------
------ ------
---
----- -------- - -------------------------- ----------------
----- ------------- - --- --------
----- -------
------ ------
---
----- ------- - ------------------------- ---------------
----- ----------- - --- --------
--------- -
----- ----------------------
---- ----------
--
------ --
-------- -
----- ----------------------
---- ---------
--
--------- ------
--
---
----- ----- - ----------------------- -------------
----- -------- ------------------ -
----- ------ - ----- ------------------ --------- -- ---
----- -------- - ----- -------------------------------
--------------------
----------------------
-
-------------------------结论
本文介绍了 Mongoose 中常见的 20 个错误及解决方法，这些错误覆盖了 Mongoose 的各个方面，包括连接、模型、数据操作、查询、更新、删除、验证、聚合、索引、外键、虚拟属性、联合索引、联合查询、日期、联合更新、嵌套文档、数组操作和联合删除。掌握这些错误的解决方法，可以让我们更好地使用 Mongoose，提高开发效率和代码质量。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/675d262de1dcc5c0fa39585a