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 has instalado recientemente el servidor de base de datos MongoDB y no puedes establecer una conexión inicial con ese servidor, verifica que hayas especificado un net.bindIp válido en tu archivo de configuracióndel servidor.
Nombre de host y puerto
Si su servidor autoalojado está escuchando en una red externa a través de net.bindIp, verifique que haya especificado su
Hostname y Port correctamente 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 crees que tu firewall puede estar bloqueando activamente las conexiones al(los) puerto(s) en el(los) que opera(n) tu(s) base(s) de datos, intenta conectarte desde una ubicación diferente, como una red doméstica o de un café internet. También puedes visitar http://portquiz.net/ para probar tu 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 crees que tu firewall podría estar bloqueando activamente las conexiones a tu base de datos, intenta conectarte desde una ubicación diferente, como tu hogar o una red de un café internet.
Los clusters de Atlas funcionan en el puerto 27017. Debes poder acceder a este puerto para acceder a tu clúster. Para comprobar si tu red local bloquea conexiones al puerto 27017, visita 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.
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.