10. Gestión de Archivos Multipart con Multer: MemoryStorage vs DiskStorage
Configura la recepción de formularios multipart/form-data, filtros estrictos por tipo MIME (MIME-type sniffing defense) y límites de peso en memoria y almacenamiento local.
Procesamiento de Formularios Multipart con Multer
Express por defecto no sabe cómo interpretar los streams binarios de multipart/form-data. Multer es el middleware oficial del ecosistema Node.js que parsea estas peticiones, extrayendo campos de texto ordinarios hacia req.body y archivos hacia req.file o req.files.
Figura 10.1: Pipeline de procesamiento en RAM sin almacenamiento intermedio en disco.
1. MemoryStorage vs DiskStorage
| Estrategia | ¿Dónde vive el archivo? | Propiedad en req.file |
Caso de Uso Recomendado |
|---|---|---|---|
| memoryStorage() | En la memoria RAM del proceso (Buffer). | req.file.buffer |
Recomendado para pipelines con Sharp o subida directa a AWS S3/Cloudflare R2. Evita escribir en disco archivos temporales que luego tendrías que limpiar manualmente. |
| diskStorage() | Escrito en el sistema de archivos del servidor (ej. /uploads). |
req.file.path, req.file.filename |
Archivos pesados (videos de 500MB, PDFs masivos) que colapsarían la memoria RAM de Node si se cargaran enteros en el heap. |
2. Blindaje de Seguridad en Subidas
- Límites estrictos (
limits.fileSize): Siempre establece un tamaño máximo (ej. 5MB) para evitar ataques DoS por agotamiento de disco o memoria. - Filtro MIME estricto (
fileFilter): No confíes en la extensión.jpgdel archivo enviado por el usuario; verifica el encabezado MIME real y rechaza ejecutables (.exe,.sh,.php).
⚡ Configuración Segura de Multer con memoryStorage y Filtro MIME
Recepción de imágenes en memoria RAM con control de tipos y captura de errores de Multer.
import multer from 'multer';
// 1. ALMACENAMIENTO EN MEMORIA (Buffer)
// Ideal cuando el archivo será procesado por Sharp o subido a la nube
const storage = multer.memoryStorage();
// 2. FILTRADO ESTRICTO DE TIPOS MIME
const fileFilter = (req, file, cb) => {
const allowedMimeTypes = ['image/jpeg', 'image/png', 'image/webp', 'image/avif'];
if (allowedMimeTypes.includes(file.mimetype)) {
cb(null, true); // Archivo aceptado
} else {
const error = new Error('Formato no permitido: sólo se admiten imágenes JPG, PNG, WebP o AVIF.');
error.code = 'INVALID_FILE_TYPE';
cb(error, false); // Archivo rechazado
}
};
// 3. INSTANCIA CONFIGURADA DE MULTER
export const uploadImage = multer({
storage,
limits: {
fileSize: 5 * 1024 * 1024, // Máximo 5 Megabytes por archivo
files: 1, // Sólo un archivo por petición
},
fileFilter,
});
// 4. MIDDLEWARE WRAPPER PARA CAPTURAR ERRORES ESPECÍFICOS DE MULTER
export const handleUploadError = (uploadMiddleware) => (req, res, next) => {
uploadMiddleware(req, res, (err) => {
if (err instanceof multer.MulterError) {
if (err.code === 'LIMIT_FILE_SIZE') {
return res.status(413).json({
success: false,
error: 'El archivo excede el tamaño máximo permitido de 5 MB.',
});
}
return res.status(400).json({ success: false, error: `Error de carga: ${err.message}` });
} else if (err) {
return res.status(400).json({ success: false, error: err.message });
}
next();
});
};
Mini-Quiz de Retención
Comprueba tu comprensión antes de pasar a la siguiente lección¿Por qué se prefiere multer.memoryStorage() sobre diskStorage() cuando se van a procesar imágenes con Sharp o subirlas a un servicio S3?
¿Tienes dudas con este tema?
Sócrates AI puede darte analogías y explicarte este código paso a paso.🚀 ¿Quieres dominar Express.js: Framework Backend & APIs Empresariales y crear proyectos reales?
Aprende arquitectura limpia, desarrollo web moderno, buenas prácticas y despliegue en producción con nuestro Bootcamp Fullstack Developer con mentorías en vivo.