Las secciones de esta página enumeran errores comunes que se observan al conectarse a MongoDB Compass y brindan posibles soluciones.
MongoDB no se ejecuta en el host y puerto proporcionados
Su conexión falló cuando Compass intentó conectarse a su base de datos en el host y puerto especificados.
Causas probables
Este error a menudo ocurre cuando:
No proporciona ningún nombre de host o un nombre de host no válido en el cuadro de diálogo de conexión de Compass.
El servidor de destino rechaza una conexión en un puerto incorrecto.
Tu clúster o servidor de MongoDB se ha apagado o el nombre de host del servidor ha cambiado.
Tiene un firewall que bloquea activamente las conexiones hacia/desde su red local.
Soluciones
La solución a este problema puede depender de cómo esté configurado tu entorno de MongoDB. Selecciona la pestaña adecuada para tu entorno de MongoDB para ver posibles soluciones:
Pruebe estas soluciones si tiene un servidor MongoDB, un conjunto de réplicas o un clúster autohospedado.
Asegúrese de que su instancia de MongoDB esté en ejecución
Compass debe conectarse a una instancia de MongoDB en ejecución. Asegúrese de tener Tiene instalado MongoDB y un proceso mongod en ejecución. También debe comprobar que el puerto donde se ejecuta su instancia de MongoDB coincida con el puerto que indicó en el cuadro de diálogo de conexión de Compass.
Configuración de archivo requerida: bindIp
Si instaló recientemente el servidor de base de datos MongoDB y no puede establecer una conexión inicial con ese servidor, verifique que haya especificado una conexión válida. Configuración net.bindIpen el archivo de configuración del servidor.
Nombre de host y puerto
Si su servidor autohospedado está escuchando en una red externa a través de, verifique que haya especificado net.bindIp su
Hostname y Port correctamente en el cuadro de diálogo de conexión de Compass.
Servidor MongoDB movido o apagado
Es posible que tu clúster o servidor de MongoDB se haya apagado o que su nombre de host haya cambiado. Contacta a tu administrador de base de datos para obtener actualizaciones sobre el estado de tu base de datos.
Firewall
Si cree que su firewall podría estar bloqueando activamente las conexiones a los puertos en los que operan sus bases de datos, intente conectarse desde otra ubicación, como la red de su casa o de un cibercafé. También puede visitar http://portquiz.net/ para probar su conexión a diferentes puertos.
Si se conecta a un clúster de Atlas, siga primero el procedimiento descrito en la página "Conectarse mediante Compass" de la documentación de Atlas. Los pasos de esa página le ayudarán a garantizar que la configuración de su conexión esté optimizada para Atlas.
Servidor MongoDB movido o apagado
Es posible que tu clúster o servidor de MongoDB se haya apagado o que su nombre de host haya cambiado. Contacta a tu administrador de base de datos para obtener actualizaciones sobre el estado de tu base de datos.
Firewall
Si cree que su firewall puede estar bloqueando activamente las conexiones a su base de datos, intente conectarse desde una ubicación diferente, como la red de su casa o de un cibercafé.
Los clústeres Atlas operan en 27017 el puerto. Debe poder acceder a este puerto para acceder a su clúster. Para comprobar si su red local bloquea las conexiones al 27017 puerto, visite http://portquiz.net:27017/.
La lista de acceso IP de Atlas no incluye su dirección
Atlas solo permite conexiones a un clúster desde direcciones incluidas en la lista de acceso IP del proyecto. Asegúrese de tener acceso a su dirección IP para poder conectarse al clúster.
Puedes utilizar el Asistente inteligente para ayudarle a depurar errores de conexión en MongoDB Compass.
El botón Insertar documento está deshabilitado y no se pueden modificar los documentos
Al usar Compass, es posible que se encuentre en un estado en el que no pueda realizar ninguna operación de escritura y solo pueda leer datos.
Posibles observaciones
Cuando estés en este estado:
Los botones Create Collection y Insert Document están deshabilitados.
No puedes modificar ninguno de tus documentos.
Causa probable
Hay dos causas probables para este comportamiento:
Estás conectado a un secundario de tu clúster, que no admite operaciones de escritura.
Estás utilizando la edición Compass Readonly, que no admite operaciones de escritura.
Soluciones
Comprobar la configuración de preferencias de lectura
En el cuadro de diálogo de conexión de Compass, configure Read Preference Primarycomo. Esto garantizará la conexión al miembro principal del clúster, que admite operaciones de escritura.
Comprobar el nombre del conjunto de réplicas
Comprueba que tu Replica Set Name sea correcto. Compass solo puede identificar correctamente el conjunto principal si el nombre del conjunto de réplicas es correcto.
Si su clúster está alojado en Atlas, puede obtener el nombre del conjunto de réplicas correcto mediante el siguiente procedimiento:
Navegar a la vista de Clusters de Atlas.
Se debe hacer clic en Connect para el clúster deseado.
Haga clic en Connect with MongoDB Compass.
Copie la cadena de conexión proporcionada.
Abra MongoDB Compass.
Haga clic en Yes para completar automáticamente la configuración de conexión.
Edición Check Your Compass
No se pueden realizar operaciones de escritura en la edición Compass Readonly. Para comprobar la edición de Compass, abra el menú desplegable de Compass y seleccione About MongoDB Compass.
Para realizar operaciones de escritura, debe descargar una edición diferente de MongoDB Compass. Para obtener más información sobre las diferencias entre las ediciones de Compass, consulte Capacidades de las ediciones de Compass.
Conexión al fragmento del clúster cerrada
Este error significa que la conexión a su clúster MongoDB se cerró antes de que se completara la configuración inicial.
Posibles observaciones
Es posible que vea un error en MongoDB Compass similar al siguiente:
connection 3 to cluster0-shard-00-00-a1b2c.mongodb.net:27017 closed
Causa probable
La fuente más común de este error es una entrada faltante en la lista de acceso IP de Atlas para la dirección IP pública donde se ejecuta Compass.
Solución
Asegúrese de que la dirección IP pública donde se ejecuta Compass esté incluida en la lista de acceso IP de su proyecto Atlas.
Para configurar su lista de acceso de Atlas:
Utilice el menú desplegable Context en la parte superior izquierda de Atlas para seleccionar el proyecto Atlas que desee.
Haz clic en la pestaña Security.
Haz clic en la opción de menú IP Access List.
Si su dirección IP no está en la lista de acceso, haga clic en Add IP Address.
Haga clic en Add Current IP Address.
Haga clic en Confirm.
Atlas reconoce qué entradas en la lista de acceso incluyen su dirección IP actual y agrega estas direcciones con (includes your current IP address).
No Primario ni Secundario es No Escribible
Este mensaje de error indica que se ha conectado a uno de los miembros secundarios de un conjunto de réplicas sin proporcionar el nombre de conjunto de réplicas correcto y sin requerir una conexión a un miembro principal en Read Preference su.
Soluciones
Verificar el nombre del conjunto de réplicas de Atlas
Debe asegurarse de proporcionar el nombre del conjunto de réplicas correcto en el cuadro de diálogo de conexión de Compass.
Si su clúster está alojado en Atlas, puede obtener el nombre del conjunto de réplicas correcto mediante el siguiente procedimiento:
Navegar a la vista de Clusters de Atlas.
Se debe hacer clic en Connect para el clúster deseado.
Haga clic en Connect with MongoDB Compass.
Copie la cadena de conexión proporcionada.
Abra MongoDB Compass.
Haga clic en Yes para completar automáticamente la configuración de conexión.
Permitir que Compass se conecte al secundario
Otra forma de resolver este error es permitir que Compass se conecte a un miembro secundario del clúster. Cambie su Read Preference a Primary Preferred o Secondary Preferred en la configuración de conexión. Esto debería permitirle evitar este error y conectarse.
Nota
Al conectarse a un miembro secundario del clúster, no se pueden crear ni modificar documentos, índices ni bases de datos. Utilice esta solución solo cuando no necesite realizar operaciones de escritura.
Tip
Para más información sobre las preferencias de lectura, consulta Preferencia de lectura en el manual de MongoDB.
Error de autenticación
Cuando intenta conectarse a su clúster usando Compass, es posible que encuentre un mensaje de error que indique Authentication Failed.
Causas probables
Este mensaje de error suele ser el resultado de una de cinco condiciones:
Tu Password no aparece después de completar automáticamente tus datos de conexión a partir de una cadena de conexión copiada. Compass requiere que ingreses manualmente tu contraseña en el cuadro de diálogo de conexión como medida de seguridad.
Sus Username y/o Password son incorrectos.
No ha configurado ningún usuario de MongoDB para su clúster Atlas.
No seleccionó el método Authentication correcto.
No especificó el valor Authentication Database correcto. Esta configuración corresponde a la opción de cadena de conexión authSource.
Nota
Para los clústeres Atlas, Authentication Database suele ser
admin.
Soluciones
Asegúrese de proporcionar los Username y Password correctos.
Asegúrese de que el usuario de MongoDB que está autenticando exista.
Verifique su Authentication Database y el mecanismo de autenticación.
Verifique que el mecanismo de autenticación seleccionado sea compatible con su base de datos MongoDB.
Consulte los registros de la brújula
Los registros de Compass pueden proporcionar información adicional sobre errores de conexión. Puede encontrar mensajes de error más detallados para ayudarle a diagnosticar el problema. Para más información, consulte Recuperar registros de Compass.