Las secciones de esta página enumeran los errores comunes que se producen al conectar con MongoDB Compass y ofrecen posibles soluciones.
MongoDB no se está ejecutando en el host y puerto proporcionados
Tu conexión falló cuando Compass intentó conectarse a tu base de datos en el host y puerto especificados.
Causas probables
Este error a menudo ocurre cuando:
No proporcionas un nombre de host o proporcionas 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.
Tienes un firewall que está bloqueando activamente las conexiones hacia / desde tu 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:
Intente estas soluciones si tiene un servidor, un set de réplicas o un clúster de MongoDB autogestionado.
Asegúrate de que tu instancia de MongoDB esté en funcionamiento
Compass debe conectarse a una instancia de MongoDB en ejecución. Asegúrate de haber instalado MongoDB y tener 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 proporciona en el cuadro de diálogo de conexión de Compass.
Configuración obligatoria del archivo config: bindIp
Si recientemente instaló el servidor de base de datos MongoDB y no puede establecer una conexión inicial con ese servidor, verifique que haya especificado una configuración válida en su archivo net.bindIpde 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 net.bindIp especificado Hostname Port correctamente y en el cuadro de diálogo de conexión de Compass.
MongoDB Server trasladado 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.
cortafuegos
Si cree que su cortafuegos podría estar bloqueando activamente las conexiones a los puertos en los que operan sus bases de datos, intente conectarse desde una ubicación diferente, como la red de su casa o la de un cibercafé. También puede visitar http://portquiz.net/ para probar su conexión a diferentes puertos.
Si te estás conectando a un clúster de Atlas, primero sigue el procedimiento descrito en la página Conéctate mediante Compass en la documentación de Atlas. Los pasos en esa página te ayudarán a garantizar que la configuración de tu conexión esté optimizada para Atlas.
MongoDB Server trasladado 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.
cortafuegos
Si cree que su cortafuegos 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 la de un cibercafé.
Los clústeres de Atlas operan en 27017 el puerto. Debe tener acceso 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 tu dirección
Atlas solo permite conexiones a un clúster desde direcciones que figuran en la lista de acceso IP del proyecto. Asegúrate de tener acceso y haber listado tu dirección IP para poder conectarte a tu clúster.
Puedes usar el asistente inteligente para ayudarte a depurar tus errores de conexión en MongoDB Compass.
Nota
El asistente inteligente de MongoDB Compass puede ayudarte a depurar errores de conexión y evaluar la configuración de tu clúster. Para acceder a esta función, conecta Compass a tu cuenta de MongoDB Atlas mediante Atlas App Connections.
Botón Insertar documento deshabilitado y no se pueden modificar documentos
Al usar Compass, es posible que te encuentres en un estado en el que no puedas realizar ninguna operación de escritura y solo puedas leer datos.
Observaciones posibles
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 preferencia de lectura
En el diálogo de conexión de Compass, configura tu Read Preference en Primary. Esto garantizará que te conectes al nodo primario de tu clúster, el cual soporta operaciones de escritura.
Verificar el nombre del set de réplicas
Asegúrese de que su Replica Set Name sea precisa. Compass solo puede identificar correctamente el primario si el nombre del set de réplicas es correcto.
Si tu clúster está alojado en Atlas, puedes obtener el nombre correcto del set de réplicas utilizando 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.
Abre MongoDB Compass.
Haz clic en Yes para rellenar automáticamente la configuración de conexión.
Consulte su edición de Compass
No se pueden realizar operaciones de escritura en la edición Compass Readonly. Puedes comprobar tu edición de Compass abriendo el menú desplegable principal de Compass y seleccionando About MongoDB Compass.
Para realizar operaciones de guardar, 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 a la partición de clúster cerrada
Este error significa que la conexión a su clúster de MongoDB se cerró antes de que se completara la configuración inicial.
Observaciones posibles
Es posible que veas 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 la ausencia de una entrada de lista de acceso IP de Atlas para la dirección IP pública donde se ejecuta Compass.
Solución
Asegúrate de que la dirección IP pública donde se ejecuta Compass esté incluida en la lista de acceso IP de tu proyecto Atlas.
Para configurar su lista de acceso de Atlas:
Utiliza el menú Context en el extremo superior izquierdo de Atlas para seleccionar el proyecto Atlas que deseas.
Haz clic en la pestaña Security.
Haz clic en la opción de menú IP Access List.
Si tu dirección IP no está en la lista de acceso, haz clic en Add IP Address.
Haga clic en Add Current IP Address.
Haga clic en Confirm.
Atlas reconoce qué entradas en la lista de accesos incluyen tu dirección IP actual y agrega estas direcciones con (includes your current IP address).
Tip
Para obtener más información sobre cómo configurar las entradas de la lista de acceso, consulta Configurar entradas de la lista de acceso en la documentación de Atlas.
No Primario ni Secundario es No Escribible
Este mensaje de error indica que te has conectado a uno de los miembros secundarios de un set de réplicas sin proporcionar el nombre correcto del set de réplicas y requieres una conexión a un primario en tu Read Preference.
Soluciones
Verifica el nombre del set de réplicas de Atlas
Debes asegurarte de ingresar el nombre correcto del set de réplicas en el diálogo de conexión de Compass.
Si tu clúster está alojado en Atlas, puedes obtener el nombre correcto del set de réplicas utilizando 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.
Abre MongoDB Compass.
Haz clic en Yes para rellenar automáticamente la configuración de conexión.
Permitir que Compass se conecte al secundario
Otro enfoque para resolver este error es permitir que Compass se conecte a un nodo secundario del clúster. Cambia tu Read Preference a Primary Preferred o Secondary Preferred en tu configuración de conexión. Esto debería permitirte evitar este error y conectarte.
Nota
Cuando te conectas a un nodo secundario del clúster, no puedes crear ni modificar documentos, índices ni bases de datos. Solo utiliza esta solución cuando no sea necesario realizar operaciones de guardado.
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:
Falta tu Password después de autocompletar tus datos de conexión a partir de una cadena de conexión copiada. Compass requiere que ingreses manualmente tu contraseña en el diálogo de conexión como una medida de seguridad.
Tu Username y/o Password son incorrectos.
No has configurado ningún usuario de MongoDB para tu clúster de Atlas.
No seleccionaste el método de Authentication correcto.
No especificó el/la Authentication Database correcto. Esta configuración corresponde a la opción de cadena de conexión authSource.
Nota
Para los clústeres de Atlas, el Authentication Database suele ser
admin.
Soluciones
Asegúrate de proporcionar el/la Username y el/la Password correctos.
Asegúrese de que el usuario de MongoDB con el que está sujetando exista.
Verifica tu Authentication Database y tu mecanismo de autenticación.
Verifica que el mecanismo de autenticación seleccionado sea compatible con tu base de datos de MongoDB.
Verificar los registros de Compass
Los registros de Compass pueden proporcionar información adicional sobre los errores de conexión. Podrás encontrar mensajes de error más detallados que te ayudarán a diagnosticar tu problema. Para obtener más información, consulta Recuperar registros de Compass.