
Análisis y prueba de concepto para CVE-2026-113872: caída del proceso por fileFilter asíncrono en multer (DoS)
fileFilter asíncrono en multerUna única solicitud de carga no autenticada puede provocar la caída de todo el proceso de Node.js de cualquier aplicación Express que utilice multer con un fileFilter asíncrono. La solicitud incluso recibe primero una respuesta normal 400; el proceso muere unos cientos de milisegundos después.
| CVE | CVE-2026-113872 |
| Aviso de GitHub | GHSA-q7qp-rjg7-q26m |
| Paquete | multer (npm) |
| Afectados | >= 2.0.0 < 2.5.0 |
| Corregido en | 2.5.0 |
| Gravedad | Alta — 7.5 (CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H) |
| Tipo | Denegación de servicio (excepción no capturada) — CWE-248, CWE-404 |
| Reportado por | Santiago Habib (@santihabib) |
| Corregido por | Ulises Gascón, Sebastián Beltrán (mantenedores de expressjs/multer) |
Este repositorio es un análisis de una vulnerabilidad que reporté y que ahora está divulgada públicamente y corregida. La prueba de concepto apunta a una versión parcheada para que los defensores puedan confirmar su exposición y verificar la corrección. Actualice a
[email protected]o posterior.
Está afectado si se cumplen todas las condiciones siguientes:
2.0.0 a 2.4.0;fileFilter llama a su callback de forma asíncrona — es decir, después de un await,
un setTimeout, una consulta a base de datos, una llamada HTTP, un análisis antivirus, etc.;.array(), .fields(), .any()).El motor de almacenamiento (disco, memoria, S3, …) y el limits configurado no suponen
ninguna diferencia. Un fileFilter totalmente síncrono no se ve afectado.
npm install multer@^2.5.0
Mantenga fileFilter sincrónico y mueva cualquier validación asíncrona a un controlador de ruta que se ejecute después de que multer haya terminado de analizar.
poc/
├── server.js # tiny Express app: memory storage + async fileFilter
├── client.js # sends one crafted multipart request
└── check.js # runs the server in a child process and reports if it survived
cd poc
npm install express [email protected] # vulnerable
node check.js
Salida esperada frente a una versión vulnerable:
[server] listening on 31046
[client] HTTP 400 rejected
[check] VULNERABLE: server process exited with code 1 (Error: Unexpected end of form)
Ahora contra la versión parcheada:
npm install [email protected]
node check.js
[server] listening on 32000
[client] HTTP 400 rejected
[check] NOT VULNERABLE: server is still running
Mismo payload, misma respuesta 400 — pero en 2.5.0 el proceso sigue vivo.
multer no analiza los cuerpos multipart por sí mismo. Canaliza la solicitud hacia busboy y reacciona a sus eventos:
req ──pipe──▶ busboy ──'file'──▶ fileStream ──▶ storage engine
│
fileFilter(req, file, cb) ← your code, may be async
Para cada parte de archivo, busboy crea un Readable (fileStream) y emite 'file'.
multer consulta tu fileFilter para decidir si lo acepta. Hasta que se llama a cb, nadie
lee ese flujo de archivo.
Tres partes del estado de multer son relevantes:
errorOccured — un pestillo activado por el primer error; las abortaciones posteriores se convierten en no-ops.pendingWrites — cuenta los archivos que han sido aceptados y se están almacenando.
Un archivo cuyo fileFilter aún está pendiente no se cuenta.done(err) — finaliza la petición: desvincula busboy, llama a next(err), y un
setImmediate después llama a busboy.removeAllListeners().Cuando busboy empuja datos de archivo hacia un flujo que nadie está leyendo, push()
devuelve false. En lugar de fallar, busboy estaciona su propio callback de escritura dentro
del flujo de archivo y espera a que alguien lo lea. Mientras tanto, el resto del cuerpo
sigue llegando y se acumula sin parsear dentro del búfer interno de busboy.
El callback estacionado solo se libera cuando el flujo de archivo se vuelve a leer — momento en el que busboy drena su búfer y continúa el parseo.
Cuando un error anterior finaliza la petición, done() desvincula busboy y programa
removeAllListeners(). Pero unpipe no vacía lo que busboy ya había almacenado en búfer,
y cuando un fileFilter aún pendiente finalmente invoca su callback, multer ejecuta:
if (errorOccured) {
appender.removePlaceholder(placeholder)
return fileStream.resume() // ← reads the parked stream → busboy resumes
}
Así que después del teardown, ese resume() es lo que vuelve a despertar al parser.
Dos partes de archivo, ambas con filtros asíncronos. La primera rechaza tras 100 ms; la segunda
acepta tras 300 ms. El segundo archivo es mayor que fileHwm (16 KiB), y el cuerpo
termina sin un límite de cierre.
| Tiempo | Evento |
|---|---|
| t0 | busboy emite 'file' dos veces; ambos filtros pendientes; pendingWrites == 0. |
| t1 | El archivo 2 llena su stream → busboy aparca su callback de escritura; el resto del cuerpo permanece en el búfer. |
| t2 | req termina; el pipe llama a busboy.end(); la finalización espera detrás de la escritura aparcada. |
| 100 ms | El filtro 1 rechaza → sin nada pendiente, se ejecuta done(err) → el cliente recibe 400. |
| siguiente tick | setImmediate elimina los listeners de busboy — busboy ahora no tiene ningún listener de 'error'. |
| 300 ms | El filtro 2 invoca el callback; errorOccured está establecido, así que multer llama a fileStream.resume(). |
| 300 ms+ | busboy drena su búfer y finaliza un cuerpo truncado → Error('Unexpected end of form'). |
| 300 ms++ | Node emite ese error en busboy; nadie está escuchando → excepción no capturada → el proceso termina. |
En producción esto se ve así: "la petición devolvió un 400 limpio, y luego el servidor se reinició sin motivo aparente." Ese retardo entre la respuesta y el fallo es lo que hace que sea confuso de diagnosticar.
Una idea anterior era hacer que busboy lanzara una excepción tras el teardown con una cabecera de parte
malformada. Esa ruta es segura: el error se lanza de forma síncrona desde dentro de
FileStream._read, que Node envuelve en un try/catch y reemite en el stream de
archivo — y multer mantiene un listener en cada stream de archivo. El fallo de _final es
distinto: se entrega a través del callback Writable de busboy en un tick posterior,
emitido en el propio busboy, donde el listener ya se ha eliminado.
multer 2.5.0 mantiene un listener de errores no-op en busboy tras el teardown, de modo que un error
tardío ya no puede convertirse en una excepción no capturada
(commit 80a2d9d):
setImmediate(() => {
busboy.removeAllListeners()
// Keep an error listener so a late busboy error after teardown cannot
// crash the process; the request has already finished.
busboy.on('error', function () {})
})
La solicitud sigue terminando con 400; la diferencia es que el proceso sobrevive.