Mongoose 是一个基于 Node.js 平台的 MongoDB（NoSQL 数据库）对象模型工具。它提供了对 MongoDB 更简单的操作和更完善的对数据的展示与校验。
但是，在使用 Mongoose 过程中，我们经常会遇到各种错误和问题。本文将会围绕 Mongoose 的使用过程中遇到的一些常见问题及其解决方法作出总结。
1. 无法连接 MongoDB 数据库
在使用 Mongoose 执行数据库操作时，首先需要建立起与 MongoDB 数据库的连接。但是，在建立连接的过程中，可能会发生以下错误：
错误信息
MongooseError: Failed to connect to MongoDB at mongodb://127.0.0.1:27017/test
解决方法
首先，需要检查 MongoDB 是否已启动。在终端中输入以下命令来启动 MongoDB：
mongod
然后，需要检查自己使用的 Mongoose 版本是否与 MongoDB 版本兼容。可以在终端中输入以下命令来查看 Mongoose 版本：
npm ls mongoose
最后，需要检查自己的 MongoDB 数据库地址和端口是否正确。方法是在 mongoose.connect 函数中填写正确的数据库地址和端口：
mongoose.connect('mongodb://localhost:27017/mydatabase', { useNewUrlParser: true, useUnifiedTopology: true })
.then(() => console.log('MongoDB connected...'))
.catch(err => console.log(err));2. Schema 和 Model 设计不当
Mongoose 中的 Schema （模式）用于定义数据结构，Model（模型）用于操作数据。如果 Schema 和 Model 设计不当，可能会导致查询结果不符预期、数据类型不对等问题。
错误信息
ValidationError: User validation failed: name: Path `name` is required.
解决方法
首先，需要确认自己定义的 Schema 是否正确无误。在 Schema 中，需要使用 required:true 来保证字段的必须存在。
const userSchema = new mongoose.Schema({
name: { type: String, required: true },
age: Number
});如果使用了 Model，需要保证 Model 中的字段和 Schema 中的字段名一致。
const User = mongoose.model('User', userSchema);然后，需要检查自己操作数据时传入的具体数据类型是否正确无误，保证数据类型和 Schema 中定义的数据类型一致。
const user = new User({
name: 'Alice',
age: '20'
}); // 这里 age 应该是 Number 类型3. 数据验证错误
在使用 Mongoose 操作数据时，会经常遇到由于数据不符合验证规则而出现错误的情况，如字符串长度、email 格式等等。
错误信息
ValidationError: User validation failed: email: `xxx` is not a valid email address.
解决方法
Mongoose 为我们提供了非常完善的数据校验功能。我们可以通过在 Schema 中添加不同的验证器来约束不同字段的取值。比如验证 email 是否符合邮箱格式：
const userSchema = new mongoose.Schema({
email: { type: String, required: true, unique: true, validate: emailValidator }
});
function emailValidator(email) {
return /\S+@\S+\.\S+/.test(email)
}在 Schema 中，我们可以使用内置的验证器，例如 required、max、min 等等。同时，也可以通过自定义的函数来对字段进行校验。
在上述代码中，我们使用自定义的 emailValidator 函数来验证 email 是否符合邮箱格式。使用 validate 选项来指定该字段的特定验证函数。
4. 密码加密和解密
在实际开发中，可以对用户密码进行加密处理，以提高安全性。但是，在加密实现上，也存在一些问题。
错误信息
(node:7636) UnhandledPromiseRejectionWarning: Error: data and salt arguments required
解决方法
在 Mongoose 中，可以使用 bcryptjs 模块来实现密码的加密和解密。
首先，安装 bcryptjs ：
npm install bcryptjs --save
接下来，创建一个加密函数和一个比较函数：
-- -------------------- ---- ------- ----- ------ - -------------------- -------- ------------------------------ - ----- ---- - ----------------------- ----- ---- - ------------------------------ ------ ------ ----- - -------- ------------------------------ ----- - ------ --------------------------------- ------ -
然后，在用户注册时，需要对用户输入的密码进行加密：
-- -------------------- ---- -------
----- ---------- - --- -----------------
------ - ----- ------- --------- ---- --
--------- - ----- ------- --------- ---- --
---
----- ---- - ---------------------- ------------
--------------------- ----- ----- ---- -- -
----- - ------ -------- - - ---------
----- -------------- - --------------------------
----- ---- - --- ------ ------ --------- -------------- ---
----- ------------
-------------- ---------- ---------------
--最后，在用户登录时，需要使用比较函数比对数据库中存储的密码和用户输入的密码是否相同：
-- -------------------- ---- -------
------------------ ----- ----- ---- -- -
----- - ------ -------- - - ---------
----- ---- - ----- -------------- ----- ---
-- ----- -- ------------------------- --------------- -
---------------- -- ---------------
- ---- -
------------------- ----- -- -----------
-
--5. 使用 Populates 查询引用类型
在使用 Mongoose 进行查询操作时，有些情况下需要查询引用类型中相关联的子文档。使用 Populates 可以完成这项操作，但也需要注意使用方法上的问题。
错误信息
TypeError: Cannot read property 'ref' of undefined
解决方法
使用 Populates 查询引用类型需要注意以下问题：
- 在定义 Schema 时，需要使用
ref字段来指定关联的模型的名称。 - 在查询时，需要使用
populate方法将关联模型的名称传入，才能正确地查询关联模型。
以下示例演示了在查询 User 模型时，将关联的 Post 文档信息也一同查询出来：
-- -------------------- ---- -------
-- ---- ------
----- ---------- - --- -----------------
------- - ----- ------------------------------- ---- ------ --
------ -------
---
----- ---- - ---------------------- ------------
-- ---- ------
----- ---------- - --- -----------------
----- -------
---
----- ---- - ---------------------- ------------
-- ----- ---- --- -------- --- ---- -------
----- -------------- ----- ------- --
------------------
---------- -- -
------------------------ -- ------- ------- ------ ---------
--
---------- -- ------------------在上述代码中，我们得到了 User 模型，并将其 posts 属性关联到 Post 模型中，并使用 populate 方法在查询时将关联的文档一同查询出来。
至此，我们总结了一些在使用 Mongoose 过程中常见的错误及解决方法，并且给出了一些示例代码。在实际开发中，我们需要善于分析和解决这些问题，以确保 Mongoose 的正常运行和数据的安全性。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64c9102d5ad90b6d0415a280