连接故障排除

配置防火墙

确认MongoDB 部署侦听的端口没有被同一网络上的防火墙阻止。MongoDB默认使用端口 27017。要学习；了解有关MongoDB使用的默认端口以及如何更改这些端口的更多信息，请参阅MongoDB Server手册中的默认MongoDB端口。

检查网络访问列表

验证您的IP地址是否列在集群的IP访问列表中。您可以在Atlas 用户界面的“网络访问”部分找到IP访问列表。要学习；了解有关如何配置IP访问列表的更多信息，请参阅Atlas文档中的配置IP访问列表条目指南。

确保MongoDB和您的客户端使用相同的IP地址

在 Node.js v17 及更高版本中，在客户端和主机都支持的情况下，DNS 解析器默认使用 IPv6。例如，如果 MongoDB 使用 IPv4 而您的客户端使用 IPv6，则驱动程序将返回之前的错误消息。

您可以将 MongoDB 部署配置为在通过 mongod 或 mongos 启动时使用 IPv6 模式。有关如何指定 IPv6 模式的更多信息，请参阅服务器手册中的 IP 绑定。

作为替代方案，您可以在客户端中显式使用 IPv4，具体方法是将 family: 4 指定为 MongoClient 的选项。

const client = new MongoClient(uri, {
  family: 4,
});

控制文件描述符的数量

文件描述符是与打开的进程关联的唯一标识符。在大多数操作系统中，来自驱动程序的每个打开的连接都与文件描述符相关联。操作系统通常对单个进程使用的文件描述符的数量有限制。如果连接数超过此限制，则可能会发生 ECONNRESET 错误。

您可以通过设置 maxPoolSize 来设立最大连接数。要解决此错误，您可以通过设置 maxPoolSize 的值来减少允许的最大连接数。或者，您可以增加操作系统中的文件限制。要学习；了解有关如何设立maxPoolSize 的更多信息，请参阅 maxPoolSize 的API文档。

设置连接字符串

当您尝试使用 SCRAM-SHA-256 连接到MongoDB时，无效的连接字符串是导致身份验证问题的最常见原因。

如果连接字符串包含用户名和密码，请确保格式正确。 如果用户名或密码包含以下任何字符，则必须对它们进行百分比编码：

: / ? # [ ] @

以下示例显示如何对“#MyP@assword?”进行百分号编码：

console.log(encodeURIComponent('#MyP@assword?'));

这会产生以下输出：

"%23MyP%40assword%3F"

验证用户是否在身份验证数据库中

要使用用户名和密码，通过 SCRAM-SHA-256 成功对连接进行身份验证，必须在身份验证数据库中定义用户名。默认身份验证数据库是 admin 数据库。要使用不同的数据库进行身份验证，请在连接字符串中指定 authSource。以下示例指示驱动程序使用 users 作为身份验证数据库：

const { MongoClient } = require("mongodb");
const uri = "mongodb://<db_username>:<db_password>@<hostname>:<port>/?authSource=users";
const client = new MongoClient(uri);

检查用户权限

确认已使用正确的用户访问 MongoDB 部署。错误中的术语“message”可以是驱动程序发送的命令。如果使用无权发送命令的用户，驱动程序可能会生成此错误。

此外，请确保用户对要发送的消息具有适当的权限。MongoDB 使用基于角色的访问控制 (RBAC) 来控制对 MongoDB 部署的访问。有关如何在 MongoDB 中配置 RBAC 的更多信息，请参阅默认 MongoDB 端口。

配置防火墙

防火墙需要具有开放端口，用于与 MongoDB 实例通信。有关配置防火墙的更多信息，请参阅“连接错误”部分中的配置防火墙。

检查连接数

每个 MongoClient 实例在其连接池中支持最大数量的并发打开连接。您可以配置定义此限制的参数 maxPoolSize。默认值为 100。如果打开的连接数已等于 maxPoolSize，则服务器将等待，直到连接可用。如果此等待时间超过 maxIdleTimeMS 值，驱动程序将返回错误。

有关连接池化工作原理的更多信息，请参阅连接池页面中的连接池概述。

设置 connectTimeoutMS

驱动程序在无法建立连接时可能会挂起，因为尝试访问无法访问的副本集节点需要很长时间。您可以使用 connectTimeoutMS 设置来限制驱动程序尝试建立连接所花费的时间。要了解有关此设置的更多信息，请参阅服务器手册中的超时选项。

应确保 connectTimeoutMS 设置不低于副本集节点的最高网络延迟。如果从节点之一的延迟为 10000 毫秒，则将 connectTimeoutMS 设置为 9000 可防止驱动程序连接到该节点。

以下示例将 connectTimeoutMS 设置为 10000 毫秒。

const client = new MongoClient(uri, {
  connectTimeoutMS: 10000,
});