前言
在 Web 开发中，数据库是不可或缺的一部分。而 MongoDB 则是一个非常流行的 NoSQL 数据库。为了能够方便地使用 MongoDB，我们通常会使用 Mongoose 这个 ODM（Object Document Mapping）库，它可以帮助我们将 JavaScript 对象映射成 MongoDB 中的文档。
而在连接 MongoDB 时，我们通常会使用 MongoDB Atlas 这个云端数据库服务。但是在连接时，遇到一些坑点和问题是非常常见的。本文将分享我在使用 Mongoose 连接 MongoDB Atlas 时遇到的问题和解决方案，希望对大家有所帮助。
连接 MongoDB Atlas
首先，我们需要在 MongoDB Atlas 上创建一个集合，并且获取到对应的 URI。打开 Atlas，进入对应的集合页面，会看到一个类似如下的 URI：
mongodb+srv://<username>:<password>@<cluster-name>.mongodb.net/<database-name>?retryWrites=true&w=majority
其中，<username> 和 <password> 是你的 Atlas 账号的用户名和密码，<cluster-name> 是 Atlas 上的集群名称，<database-name> 是你想要连接的数据库名称。
接着，我们在项目中安装 Mongoose：
npm install mongoose
然后，在项目中创建一个 database.js 文件，并引入 Mongoose：
const mongoose = require('mongoose');接下来，我们将尝试使用 Mongoose 连接到 Atlas 上的数据库。
连接时遇到的问题
问题一：无法连接到 Atlas
在使用 Mongoose 的 connect 方法连接 Atlas 时，可能会出现以下错误：
UnhandledPromiseRejectionWarning: MongoNetworkError: connection timed out
或者：
Connection failed: Error: connection closed
这通常是由于网络连接问题导致的，可能是网络不稳定或者防火墙导致的。我们可以尝试在连接时添加一些选项：
-- -------------------- ---- ------- --------------------- - ---------------- ----- ------------------- ----- ----------------- ------ --------------- ---- ---------- -- - ---------------------- -- ---------- ------------ -- - ------------------------- --------- ----- ---
其中的 useNewUrlParser 和 useUnifiedTopology 选项是必要的，而 useFindAndModify 和 useCreateIndex 则是可选的。
问题二：认证失败
在使用 Mongoose 的 connect 方法连接 Atlas 时，可能会出现以下错误：
Connection failed: MongoError: authentication failed
或者：
Connection failed: Error: password authentication failed for user "<username>"
这通常是由于 URI 中的用户名或密码不正确导致的。我们需要检查一下 URI 中的用户名和密码是否正确，并且确保我们的 MongoDB 用户拥有足够的权限访问对应的数据库。
解决方案
如果出现了网络连接问题，我们可以尝试将选项中的 connectTimeoutMS 设置得更长一些：
-- -------------------- ---- ------- --------------------- - ---------------- ----- ------------------- ----- ----------------- ------ --------------- ----- ----------------- ----- ---------- -- - ---------------------- -- ---------- ------------ -- - ------------------------- --------- ----- ---
如果出现了认证失败的问题，我们需要检查一下 Atlas 上的用户设置和数据库设置，确保用户名和密码正确，并且 MongoDB 用户拥有访问对应数据库的权限。
另外，我们可以尝试通过 Atlas 上的 IP 白名单来控制允许访问的 IP 地址。如果我们的服务器的 IP 地址不在白名单上，则会被拒绝连接。我们可以在 Atlas 的集合设置页面中添加 IP 地址，或者使用 0.0.0.0/0 来允许任何 IP 地址访问我们的数据库。
最后，我们可以通过 Mongoose 的事件来监听连接状态，并进行相应的处理：
-- -------------------- ---- ------- ------------------------------------ -- -- - ----------------------- -- ---------- --- ----------------------------------- -- -- - ---------------------- -- ---------- --- ------------------------------- --- -- - ------------------------- -------- ----- --- -------------------------------------- -- -- - ------------------------- ---- ---------- ---
总结
本文介绍了使用 Mongoose 连接 MongoDB Atlas 时可能遇到的问题和解决方案。虽然连接 MongoDB 可能会出现一些问题，但是只要我们仔细检查并进行相应的处理，就能够轻松地连接到 Atlas 上的数据库，从而开发出更加优秀的 Web 应用。
完整示例代码如下：
-- -------------------- ---- ------- ----- -------- - -------------------- ----- --- - ------------------------------------------------------------------------------------------------------------- --------------------- - ---------------- ----- ------------------- ----- ----------------- ------ --------------- ----- ----------------- ----- ---------- -- - ---------------------- -- ---------- ------------ -- - ------------------------- --------- ----- --- ------------------------------------ -- -- - ----------------------- -- ---------- --- ----------------------------------- -- -- - ---------------------- -- ---------- --- ------------------------------- --- -- - ------------------------- -------- ----- --- -------------------------------------- -- -- - ------------------------- ---- ---------- ---
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64c808755ad90b6d04129449