MongoDB
Explica qué aporta Mongoose sobre el driver de MongoDB mediante schemas, models, casting, validation, middleware y una capa documental orientada a Node.js.
Mongoose es un ODM construido sobre el driver oficial. Añade schemas de aplicación, casting, validation, models, middleware, virtuals, population y documentos hidratados. Facilita productividad, pero no modifica las garantías reales de MongoDB.
aplicación
→ Mongoose
→ driver oficial
→ MongoDB ServerEl planner, índices, atomicidad, replication, sharding y write concerns siguen perteneciendo al servidor.
Cada comodidad tiene coste de CPU, memoria y comportamiento implícito.
Mongoose también administra una conexión/pool mediante el driver:
await mongoose.connect(uri, {
maxPoolSize: 20
});Conecta una vez por proceso y cierra durante graceful shutdown. No llames connect() en cada request.
const orderSchema = new Schema({
businessId: {
type: Schema.Types.ObjectId,
required: true,
index: true
},
status: {
type: String,
enum: ['pending', 'confirmed', 'cancelled'],
required: true
},
total: {
type: Schema.Types.Decimal128,
required: true
}
}, {
timestamps: true,
strict: true
});
const Order = model('Order', orderSchema);El Schema configura comportamiento Mongoose. El Model ejecuta operaciones sobre una colección.
Mongoose puede convertir strings a ObjectId, numbers o dates. Esto ayuda, pero también puede ocultar input incorrecto o generar CastError tarde.
Valida input antes del ODM. No uses casting como seguridad ni como sustituto de DTOs.
Document validation suele ejecutarse antes de save(). Updates requieren atención:
await Order.updateOne(filter, update, {
runValidators: true
});Incluso con validators:
this cambia por contexto;Replica invariantes importantes mediante schema validation e índices del servidor.
Una query normal devuelve Mongoose Documents con:
save();Esto consume más memoria que objetos simples. Para lecturas que solo serializan, lean() puede ser mejor.
save() trabaja con un documento hidratado y change tracking. Es cómodo para lógica document-oriented, pero implica leer antes cuando no tienes el documento.
Para cambios atómicos y concurrentes, utiliza updates con filtros de precondition:
const order = await Order.findOneAndUpdate(
{
_id: orderId,
businessId,
status: 'pending'
},
{
$set: {
status: 'confirmed'
}
},
{
new: true,
runValidators: true
}
);No hagas read-modify-save cuando $inc, $set o versioning resuelven la carrera.
Mongoose usa __v como version key y ofrece opciones de optimistic concurrency en contextos compatibles. Comprueba qué operaciones participan; no asumas que cualquier updateOne() valida versión automáticamente.
Para workflows críticos, incluye versión explícita en el filtro y revisa el resultado.
populate() resuelve referencias desde otras colecciones. No es un join gratuito:
Compara embedding, $lookup, denormalización y population según access pattern.
Hooks pre/post pueden ejecutarse para documents, queries, models y aggregations. Son útiles para comportamiento transversal, pero pueden ocultar efectos.
No dependas de middleware para:
Virtuals no se guardan. Pueden calcular URLs o nombres, pero no deben confundirse con campos persistidos o indexables.
Configura toJSON/toObject para DTOs, aunque una capa de mapping explícita suele dar más control sobre secretos y BSON.
Declarar index: true o schema.index() expresa índices, pero autoIndex en producción debe decidirse deliberadamente. Construir índices al arrancar múltiples instancias puede ser costoso.
Gestiona índices mediante migrations o deployment controlado y valida con syncIndexes() solo entendiendo qué puede eliminar o crear.
Plugins reducen repetición, pero añaden comportamiento global. Antes de adoptar uno revisa:
const session = await mongoose.startSession();
try {
await session.withTransaction(async () => {
await Order.create([order], { session });
await Inventory.updateOne(filter, update, { session });
});
} finally {
await session.endSession();
}Pasa session a cada operación. No uses effects externos ni paralelismo inseguro dentro del callback.
La inferencia de schemas ayuda, pero tipos complejos, plugins, virtuals y lean pueden desalinearse. Separa:
No cures errores de tipos con any o assertions masivas.
strict y validación runtime;Mongoose no es una barrera de seguridad automática.
runValidators;this inesperado;save() para contadores concurrentes;autoIndex sin control;save, update y bulk por separado.Mongoose añade una capa útil de modelado y ergonomía, pero sus schemas y hooks solo gobiernan operaciones que pasan por el ODM. Diseña primero MongoDB, utiliza updates atómicos, controla índices y population, y trata casting, validation y middleware como comportamiento explícito que necesita tests.
Mongoose schemas y models.