连接故障排除

检查您的连接字符串

验证连接字符串中的主机名和端口号是否都准确。MongoDB实例的默认端口号为27017，但您可以将MongoDB配置为在其他端口上进行通信。

配置您的防火墙

验证您的MongoDB部署所监听的端口不会被同一网络中的防火墙阻止。MongoDB默认使用端口27017。有关MongoDB使用的默认端口以及如何更改端口的更多信息，请参阅默认MongoDB端口。

确保MongoDB和您的客户端使用相同的协议

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

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

作为替代方案，您可以通过指定 family: 4 作为 MongoClient 的 选项，显式地在客户端使用 IPv4。

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

控制文件描述符数量

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

您可以通过设置 maxPoolSize 来设置最大连接数。为了解决此错误，您可以减少最大允许连接数，通过设置 maxPoolSize 的值。或者，您也可以增加操作系统的文件描述符限制。

检查您的连接字符串

无效的连接字符串是在尝试使用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实例来检查这是否是问题。同一台机器上的部署不需要任何授权即可连接。

检查用户权限

请确认您已使用正确的用户访问MongoDB部署。错误中的“消息”可以是驱动程序发送的命令。如果您使用的是没有发送命令权限的用户，驱动程序可能会生成此错误。

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

配置您的防火墙

防火墙需要开放一个端口以与MongoDB实例进行通信。有关配置防火墙的更多信息，请参阅连接错误部分中的配置您的防火墙。

检查连接数

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

有关连接池如何工作的更多信息，请参阅FAQ中的Node驱动程序中连接池是如何工作的？。

检查连接数量

为了创建更多的开放连接，增加 maxPoolSize 的值。有关检查连接数量的更多信息，请参阅错误发送消息部分的 检查连接数量。

设置 connectTimeoutMS

当驱动程序无法在过长的时间内建立连接（因为它尝试连接无法到达的副本集节点）时，它可能会挂起。您可以使用 connectTimeMS 设置来限制驱动程序尝试建立连接的时间。有关此设置的更多信息，请参阅服务器手册中的 超时选项。

确保 connectTimeoutMS 设置不低于集合成员的最高网络延迟。如果集合的一个辅助成员的延迟为 10000 毫秒，将 connectTimeoutMS 设置为 9000 将防止驱动程序连接到该成员。

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

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

检查连接数

到服务器的连接数可能超过 maxPoolSize。有关检查连接数的更多信息，请参阅错误发送消息部分中的检查连接数。