MongoDB
Explica cómo definir schemas y models en Mongoose con tipos, defaults, validadores, índices, métodos y opciones de serialización.
Un describe cómo Mongoose interpreta una colección: tipos, casting, defaults, validators, índices, middleware y opciones. Un enlaza ese schema con una colección y expone operaciones de lectura y escritura.
Schema
→ reglas de Mongoose
→ Model
→ colección MongoDBEl schema del ODM no sustituye el schema real del servidor. Solo se aplica a operaciones que pasan por Mongoose.
const productSchema = new Schema({
businessId: {
type: Schema.Types.ObjectId,
required: true,
index: true
},
sku: {
type: String,
required: true,
trim: true
},
status: {
type: String,
enum: ['active', 'inactive'],
default: 'active'
},
price: {
type: Schema.Types.Decimal128,
required: true
}
}, {
timestamps: true,
strict: true,
versionKey: '__v'
});Cada opción modifica comportamiento en runtime. Debe probarse en inserts, saves y updates, porque no todas las rutas ejecutan las mismas reglas.
Mongoose puede convertir strings a ObjectId, dates o numbers. Esto facilita formularios, pero también puede ocultar datos incorrectos.
await Product.findById('64f...');El string puede convertirse a ObjectId. Un valor inválido produce CastError. Valida antes de llegar al Model para devolver errores de entrada claros.
required valida presencia según semántica de Mongoose. No garantiza que:
Para invariantes críticas combina Mongoose validation, $jsonSchema e índices.
status: {
type: String,
default: 'active'
}Los defaults se aplican cuando el valor es undefined, no necesariamente cuando es null. En upserts pueden intervenir opciones como setDefaultsOnInsert; verifica el comportamiento exacto de la versión.
No uses defaults para ocultar datos viejos mal migrados.
price: {
type: Schema.Types.Decimal128,
validate: {
validator(value) {
return value && value.toString() !== '0';
},
message: 'Price must be greater than zero'
}
}Los validators síncronos o asíncronos sirven para reglas locales. No son adecuados para garantizar unicidad o consultar otra colección bajo concurrencia.
save() valida documentos hidratados. updateOne() y findOneAndUpdate() requieren revisar runValidators:
await Product.updateOne(filter, update, {
runValidators: true
});Aun así, update validators tienen contexto y cobertura distintos. Prueba operadores como $set, $unset, $push y pipelines.
strict: true controla campos no definidos al construir o actualizar documentos. Puede descartarlos o producir errores según configuración.
No es una defensa suficiente contra operator injection: un atacante aún puede influir filtros, operadores y paths permitidos si copias input directamente.
Controla cómo se tratan campos desconocidos en filtros. Los defaults han cambiado entre versiones de Mongoose, por lo que debes fijar la política y probarla.
Un filtro reducido silenciosamente podría convertirse en una consulta más amplia de lo esperado. Valida y construye filtros explícitos.
const itemSchema = new Schema({
productId: {
type: Schema.Types.ObjectId,
required: true
},
quantity: {
type: Number,
min: 1,
required: true
}
}, { _id: false });Puedes embeberlo:
items: {
type: [itemSchema],
validate: value => value.length > 0
}Decide si cada elemento necesita _id. Desactivarlo reduce tamaño cuando no se identifica individualmente.
{ timestamps: true }Añade createdAt y updatedAt en operaciones compatibles. No confíes en ellos como audit log: no explican quién cambió, por qué ni el valor anterior.
Writes externos pueden no mantenerlos.
productSchema.index(
{ businessId: 1, sku: 1 },
{ unique: true }
);unique: true declara un índice; no es validator. Los duplicados se reportan como error del servidor.
En producción controla cuándo se construyen índices. autoIndex durante el arranque de múltiples instancias puede causar builds inesperados.
const Product = mongoose.model('Product', productSchema);Mongoose pluraliza normalmente el nombre para elegir colección. Puedes fijarla:
const Product = mongoose.model('Product', productSchema, 'products');Evita depender de pluralización implícita en sistemas donde nombres son parte del contrato.
En Next.js o entornos de desarrollo, compilar el mismo model dos veces produce errores. Patrón:
export const Product =
mongoose.models.Product ?? mongoose.model('Product', productSchema);Esto solo evita recompilación; no resuelve múltiples conexiones ni schemas desincronizados.
Permiten variantes en una colección:
const paymentSchema = new Schema({ amount: Schema.Types.Decimal128 }, {
discriminatorKey: 'type'
});
const Payment = model('Payment', paymentSchema);
const CardPayment = Payment.discriminator('card', new Schema({
providerReference: String
}));Son útiles cuando las variantes comparten lifecycle y consultas. Si difieren mucho, una colección única puede generar muchos campos optional e índices complejos.
Methods actúan sobre documentos; statics sobre Model; query helpers encadenan queries.
Mantén lógica de infraestructura cerca del Model, pero evita esconder casos de uso completos, autorización o efectos externos dentro de métodos difíciles de probar.
toJSON y toObject pueden ocultar __v o transformar _id, pero no deben ser la única barrera para secretos. Un DTO explícito es más predecible.
Reglas importantes deben existir también en MongoDB:
{
$jsonSchema: {
bsonType: 'object',
required: ['businessId', 'sku', 'price']
}
}Así proteges scripts, imports y otros servicios.
null;required protege toda escritura;unique como validator;autoIndex sin control;save().updateOne() con y sin validators.Schema y Model aportan ergonomía, casting y validación dentro de Mongoose. No representan automáticamente las restricciones del servidor. Define tipos y opciones con intención, controla índices, valida updates y replica invariantes críticas en MongoDB.
unique no es validator?strictQuery?Population.