Solución de problemas de conexión

Configurar su firewall

Verifique que los puertos que escucha su implementación de MongoDB no estén bloqueados por un firewall en la misma red. MongoDB usa el puerto 27017 por defecto. Para obtener más información sobre los puertos predeterminados que usa MongoDB y cómo cambiarlos, consulte "Puerto predeterminado de MongoDB" en el manual del servidor MongoDB.

Verifique su lista de acceso a la red

Verifique que su dirección IP aparezca en la lista de acceso IP de su clúster. Puede encontrarla en la sección Acceso a la red de la interfaz de usuario de Atlas. Para obtener más información sobre cómo configurar su lista de acceso IP, consulte la guía "Configurar entradas de la lista de acceso IP" en la documentación de Atlas.

Asegúrese de que MongoDB y su cliente utilicen la misma dirección IP

En Node.js v17 y versiones posteriores, el solucionador DNS usa IPv6 por defecto cuando tanto el cliente como el host admiten ambos. Por ejemplo, si MongoDB usa IPv4 y el cliente usa IPv6, el controlador devuelve el mensaje de error anterior.

Puede configurar su implementación de MongoDB para usar el IPv6 modo al iniciar con mongod mongoso. Para obtener más información sobre cómo especificar IPv6 el modo, consulte Enlace de IP en el manual del servidor.

Como alternativa, puede utilizar explícitamente IPv4 con su cliente especificando family: 4 como una opción para su MongoClient.

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

Controlar el número de descriptores de archivos

Un descriptor de archivo es un identificador único asociado a un proceso abierto. En la mayoría de los sistemas operativos, cada conexión abierta desde el controlador se asocia a un descriptor de archivo. Los sistemas operativos suelen tener un límite en la cantidad de descriptores de archivo que utiliza un solo proceso. Puede producirse un error ECONNRESET si el número de conexiones supera este límite.

Puede establecer el número máximo de conexiones maxPoolSize configurando. Para solucionar este error, puede reducir el número máximo de conexiones permitidas configurando el maxPoolSize valor. También puede aumentar el límite del descriptor de archivo en su sistema operativo. Para obtener más información sobre cómo maxPoolSize configurar, consulte la documentación de la API de maxPoolSize.

Comprueba tu cadena de conexión

Una cadena de conexión no válida es la causa más común de problemas de autenticación cuando intenta conectarse a MongoDB mediante SCRAM-SHA-256.

Si su cadena de conexión contiene un nombre de usuario y una contraseña, asegúrese de que tengan el formato correcto. Si el nombre de usuario o la contraseña incluyen alguno de los siguientes caracteres, deben estar codificados con un porcentaje:

: / ? # [ ] @

El siguiente ejemplo muestra cómo codificar porcentualmente "#MiContraseña?":

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

Esto da como resultado el siguiente resultado:

"%23MyP%40assword%3F"

Verificar que el usuario esté en la base de datos de autenticación

Para autenticar correctamente una conexión usando un nombre de usuario y una contraseña con SCRAM-SHA-256, el nombre de usuario debe estar definido en la base de datos de autenticación. La base de datos de autenticación predeterminada es admin. Para usar una base de datos diferente para la autenticación, especifique authSource en la cadena de conexión. El siguiente ejemplo indica al controlador que use users como base de datos de autenticación:

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

Comprobar los permisos de usuario

Verifique que haya accedido a la implementación de MongoDB con el usuario correcto. El término "mensaje" en el error puede ser un comando enviado por el controlador. Si utiliza un usuario sin permisos para enviar el comando, el controlador podría generar este error.

También asegúrate de que el usuario tenga los permisos adecuados para el mensaje que estás enviando. MongoDB utiliza el control de acceso basado en roles (RBAC) para controlar el acceso a una implementación de MongoDB. Para obtener más información sobre cómo configurar el RBAC en MongoDB, consulta Puerto por defecto de MongoDB.

Configurar su firewall

El firewall debe tener un puerto abierto para comunicarse con la instancia de MongoDB. Para obtener más información sobre la configuración del firewall,consulte "Configurar el firewall" en la sección "Error de conexión".

Comprobar el número de conexiones

Cada instancia de MongoClient admite un número máximo de conexiones simultáneas abiertas en su pool de conexiones. Se puede configurar el parámetro maxPoolSize que define este límite. El valor por defecto es 100. Si ya hay un número de conexiones abiertas igual a maxPoolSize, el servidor espera hasta que una conexión esté disponible. Si este tiempo de espera supera el valor de maxIdleTimeMS, el controlador responde con un error.

Para obtener más información sobre cómo funciona la agrupación de conexiones, consulte Descripción general de la agrupación de conexiones en la página Agrupaciones de conexiones.

Establecer connectTimeoutMS

El controlador puede bloquearse si no puede establecer una conexión porque tarda demasiado en alcanzar nodos del conjunto de réplicas inaccesibles. Puede limitar el tiempo que el controlador tarda en establecer la conexión mediante la connectTimeoutMS configuración. Para obtener más información sobre esta configuración, consulte las Opciones de tiempo de espera en el manual del servidor.

Asegúrese de que el valor de connectTimeoutMS no sea inferior a la latencia de red máxima que tenga para un miembro del conjunto. Si uno de los miembros secundarios tiene una latencia de 10000 milisegundos, establecer connectTimeoutMS en 9000 impide que el controlador se conecte a ese miembro.

El siguiente ejemplo establece connectTimeoutMS en 10000 milisegundos.

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