Tema 10 · Multer Uploads

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.

Arquitectura de Subida de Archivos con Multer y Sharp

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 .jpg del 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.

uploadMiddleware.js
Solo lectura
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
1 Pregunta
Pregunta 1
¿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.

🏛️ Autoría y Propiedad Intelectual: Obra educativa original de Juan Sebastián Amador para Kilopolis Academia, estructurada sobre las especificaciones y estándares abiertos del W3C, el estándar vivo de WHATWG y la documentación oficial de código abierto. © Todos los derechos reservados.