MongoDB
Configura MongoDB Server, mongosh, Compass y el driver oficial, entendiendo connection strings, TLS, authSource, replica sets, pooling y errores de conexión.
Trabajar con MongoDB requiere distinguir cuatro piezas que suelen mezclarse: el servidor, el shell, las herramientas visuales y el driver de la aplicación.
mongosh permite enviar comandos manualmente.Instalar una de estas piezas no instala necesariamente las demás. Tampoco una connection string correcta garantiza acceso: deben coincidir red, autenticación, TLS, topología, permisos y versión del driver.
Una aplicación necesita localizar uno o varios servidores, demostrar quién es, negociar una conexión segura, descubrir la topología y elegir un nodo capaz de ejecutar cada operación.
connection string
↓
DNS y red
↓
TLS
↓
autenticación
↓
descubrimiento de topología
↓
selección de servidor
↓
connection poolUn error que aparece como “no conecta” puede ocurrir en cualquiera de esas fases. Por eso conviene diagnosticar por capas en vez de cambiar opciones al azar.
El servidor se ejecuta mediante mongod. Puede ser local, estar en un contenedor, formar parte de un replica set o estar administrado por Atlas.
Para aprendizaje, una instancia local permite entender procesos, archivos y configuración. Para producción, un standalone normalmente no ofrece la disponibilidad requerida.
mongosh es el shell moderno. Sirve para:
explain();El shell no reemplaza el driver. Una aplicación no debería ejecutar comandos invocando mongosh como proceso externo.
Compass ayuda a explorar documentos, construir filtros, observar schema y revisar planes. Es útil para aprendizaje y diagnóstico, pero no representa automáticamente el comportamiento de una aplicación bajo concurrencia o carga.
El driver implementa protocolo, pooling, selección de servidores, BSON, sessions y retries compatibles. Debe elegirse una versión soportada por la versión del servidor y el runtime utilizado.
Una URI típica puede verse así:
mongodb://app_user:secret@db1.example.com:27017,db2.example.com:27017/orders?replicaSet=rs0&authSource=admin&tls=trueSus partes principales son:
mongodb://
usuario:contraseña
@
hosts
/
database por defecto
?
opcionesmongodb:// enumera hosts de forma explícita.mongodb+srv:// utiliza DNS SRV para descubrir hosts y puede obtener algunas opciones desde registros DNS.El formato SRV simplifica URIs administradas, pero añade dependencia del DNS.
El puerto predeterminado es 27017, pero no debe asumirse en todos los entornos. En un replica set se pueden listar varios seed hosts; no son necesariamente los únicos miembros que el driver descubrirá.
La database en la ruta puede funcionar como database por defecto. No siempre es la database donde vive el usuario de autenticación.
Indica la database contra la que se autentican las credenciales. Un usuario creado en admin puede acceder a otra database según sus roles, pero la autenticación debe señalar el origen correcto.
Ayuda a confirmar que el driver se conecta al replica set esperado. También evita tratar accidentalmente un miembro individual como un standalone.
tls=true solicita cifrado en tránsito. En producción, el cliente también debe validar certificados y hostname. Desactivar validación para “hacer que conecte” elimina una defensa importante frente a intermediarios y servidores falsos.
import { MongoClient, ServerApiVersion } from 'mongodb';
const uri = process.env.MONGODB_URI;
if (!uri) {
throw new Error('MONGODB_URI is required');
}
export const mongoClient = new MongoClient(uri, {
serverApi: {
version: ServerApiVersion.v1,
strict: true,
deprecationErrors: true
},
serverSelectionTimeoutMS: 5_000,
connectTimeoutMS: 10_000
});
export async function connectMongo(): Promise<void> {
await mongoClient.connect();
await mongoClient.db('admin').command({ ping: 1 });
}Flujo del ejemplo:
MongoClient representa un cliente reutilizable con pool.connect() establece la capacidad de conexión, pero el ping confirma una operación contra el servidor.En producción también conviene manejar señales de shutdown y cerrar el cliente una sola vez:
async function shutdown(signal: string): Promise<void> {
console.info(`Received ${signal}`);
await mongoClient.close();
process.exit(0);
}
process.on('SIGTERM', () => void shutdown('SIGTERM'));
process.on('SIGINT', () => void shutdown('SIGINT'));No debe crearse y cerrarse un cliente por cada request. Esa práctica genera connection storms, latencia y presión sobre el servidor.
Existen tres enfoques comunes.
Permite ejecutar mongod directamente y conocer rutas, servicios y configuración del sistema. Su mantenimiento depende del sistema operativo y de cómo se instalen versiones.
Facilita reproducibilidad y aislamiento. Deben definirse volumen persistente, autenticación, health check y recursos. Un volumen local conserva datos del contenedor, pero no es una estrategia de backup.
Ejemplo educativo:
services:
mongodb:
image: mongo:8
restart: unless-stopped
environment:
MONGO_INITDB_ROOT_USERNAME: root
MONGO_INITDB_ROOT_PASSWORD: local-only-password
ports:
- '127.0.0.1:27017:27017'
volumes:
- mongodb_data:/data/db
volumes:
mongodb_data:Aspectos importantes:
mongo:8 sigue permitiendo cambios de minor; para reproducibilidad estricta se puede fijar una versión concreta compatible.Atlas reduce tareas operativas y ofrece connection strings, monitoring, backups y networking administrado. Aun así, deben configurarse database users, network access, TLS, roles y coste.
Atlas no es obligatorio para usar MongoDB y sus servicios específicos deben distinguirse del servidor core.
Una URI mongodb+srv:// consulta DNS SRV para descubrir hosts. Esto permite cambiar miembros sin reescribir la URI, pero puede fallar por:
Al diagnosticar, comprueba resolución DNS antes de asumir un error de contraseña.
En Atlas, una IP allowlist controla desde qué redes se permite iniciar conexiones públicas. Añadir 0.0.0.0/0 expone la entrada a cualquier origen y debe evitarse salvo un escenario temporal y controlado.
En entornos de producción son preferibles redes privadas, peering o private endpoints cuando la arquitectura y el plan lo permiten.
En self-hosted, además de firewall deben configurarse binding, TLS, autenticación y segmentación. No expongas 27017 públicamente por comodidad.
La compatibilidad no depende solo de que “ambos sean recientes”. Deben revisarse:
Una nueva versión del driver puede cambiar defaults o retirar APIs aunque el servidor siga funcionando.
El host respondió que no existe un proceso escuchando en ese puerto. Revisa que mongod esté activo, el puerto publicado y la dirección correcta.
El driver no encontró a tiempo un servidor compatible. Puede deberse a red, DNS, TLS, replica set incorrecto, primary no disponible o read preference imposible de satisfacer.
Revisa usuario, password URL-encoded, mecanismo, authSource y roles. Una contraseña con @, : o / debe codificarse correctamente en la URI.
No se corrige desactivando TLS. Verifica CA, hostname, expiración, cadena de confianza y reloj del sistema.
La URI puede señalar un replicaSet diferente al configurado. También ocurre cuando se conecta un hostname que el cluster anuncia con otro nombre no resoluble desde el cliente.
Compara red real, variables de entorno, DNS, certificados, runtime, opciones y versión del driver. Compass puede ejecutarse desde otra máquina o interpretar una configuración distinta.
Desarrollo, pruebas, staging y producción deben usar:
No copies datos sensibles de producción a un portátil sin anonimización, autorización y controles.
authSource esperado?Conectarse a MongoDB no es pegar una URI hasta que funcione. Es establecer una cadena de confianza y descubrimiento entre aplicación, red, credenciales, TLS, topología y driver. Cada entorno debe tener configuración y permisos propios.
authSource?MongoClient por request perjudica al sistema?BSON y documentos.