
Análise e prova de conceito para CVE-2026-113872: falha do processo assíncrono fileFilter do multer (DoS)
fileFilter do multerUma única requisição de upload não autenticada pode derrubar todo o processo Node.js de qualquer
aplicação Express que utilize multer com um
fileFilter assíncrono. A requisição ainda recebe uma resposta 400 normal primeiro;
o processo morre algumas centenas de milissegundos depois.
| CVE | CVE-2026-113872 |
| Aviso do GitHub | GHSA-q7qp-rjg7-q26m |
| Pacote | multer (npm) |
| Afetado | >= 2.0.0 < 2.5.0 |
| Corrigido em | 2.5.0 |
| Severidade | Alta — 7.5 (CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H) |
| Tipo | Negação de Serviço (exceção não capturada) — CWE-248, CWE-404 |
| Relator | Santiago Habib (@santihabib) |
| Correção por | Ulises Gascón, Sebastián Beltrán (mantenedores do expressjs/multer) |
Este repositório é um relato de uma vulnerabilidade que reportei e que agora está divulgada publicamente e corrigida. A prova de conceito tem como alvo uma versão corrigida para que os defensores possam confirmar sua exposição e verificar a correção. Atualize para
[email protected]ou posterior.
Você está afetado se todas as condições a seguir forem verdadeiras:
2.0.0 a 2.4.0;fileFilter chama seu callback de forma assíncrona — ou seja, após um await,
um setTimeout, uma consulta ao banco de dados, uma chamada HTTP, uma verificação de vírus, etc.;.array(), .fields(), .any()).O mecanismo de armazenamento (disco, memória, S3, …) e o limits configurado não fazem
diferença. Um fileFilter totalmente síncrono não é afetado.
npm install multer@^2.5.0
Mantenha o fileFilter síncrono e mova qualquer validação assíncrona para um manipulador de rota que seja executado depois que o multer terminar a análise.
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
Saída esperada contra uma versão vulnerável:
[server] listening on 31046
[client] HTTP 400 rejected
[check] VULNERABLE: server process exited with code 1 (Error: Unexpected end of form)
Agora contra a versão corrigida:
npm install [email protected]
node check.js
[server] listening on 32000
[client] HTTP 400 rejected
[check] NOT VULNERABLE: server is still running
Mesmo payload, mesma resposta 400 — mas em 2.5.0 o processo permanece vivo.
O multer não analisa corpos multipart por conta própria. Ele encaminha a requisição para o busboy e reage aos seus eventos:
req ──pipe──▶ busboy ──'file'──▶ fileStream ──▶ storage engine
│
fileFilter(req, file, cb) ← your code, may be async
Para cada parte de arquivo, o busboy cria um Readable (fileStream) e emite 'file'.
O multer consulta seu fileFilter para decidir se o aceita. Até que cb seja chamado, ninguém
lê esse fluxo de arquivo.
Três partes do estado do multer importam:
errorOccured — um latch definido pelo primeiro erro; abortos posteriores tornam-se no-ops.pendingWrites — conta os arquivos que foram aceitos e estão sendo armazenados.
Um arquivo cujo fileFilter ainda está pendente não é contado.done(err) — encerra a requisição: desfaz o pipe do busboy, chama next(err) e, um
setImmediate depois, chama busboy.removeAllListeners().Quando o busboy empurra dados de arquivo para um fluxo que ninguém está lendo, push()
retorna false. Em vez de falhar, o busboy estaciona seu próprio callback de escrita dentro
do fluxo de arquivo e espera que alguém o leia. Enquanto isso, o restante do corpo
continua chegando e se acumula sem ser analisado dentro do buffer interno do busboy.
O callback estacionado só é liberado quando o fluxo de arquivo é lido novamente — momento em que o busboy drena seu buffer e continua a análise.
Quando um erro anterior encerra a requisição, done() desfaz o pipe do busboy e agenda
removeAllListeners(). Mas unpipe não esvazia o que o busboy já havia armazenado em buffer,
e quando um fileFilter ainda pendente finalmente chama de volta, o multer executa:
if (errorOccured) {
appender.removePlaceholder(placeholder)
return fileStream.resume() // ← reads the parked stream → busboy resumes
}
Então, após o teardown, é esse resume() que desperta o parser novamente.
Duas partes de arquivo, ambas com filtros assíncronos. A primeira rejeita após 100 ms; a segunda
aceita após 300 ms. O segundo arquivo é maior que fileHwm (16 KiB), e o corpo
termina sem um boundary de fechamento.
| Tempo | Evento |
|---|---|
| t0 | busboy emite 'file' duas vezes; ambos os filtros pendentes; pendingWrites == 0. |
| t1 | O arquivo 2 preenche seu stream → busboy estaciona seu callback de escrita; o restante do corpo permanece em buffer. |
| t2 | req termina; o pipe chama busboy.end(); a finalização aguarda atrás da escrita estacionada. |
| 100 ms | O filtro 1 rejeita → sem nada pendente, done(err) executa → o cliente recebe 400. |
| próximo tick | setImmediate remove os listeners do busboy — o busboy agora não tem nenhum listener 'error'. |
| 300 ms | O filtro 2 chama de volta; errorOccured está definido, então multer chama fileStream.resume(). |
| 300 ms+ | busboy drena seu buffer e finaliza um corpo truncado → Error('Unexpected end of form'). |
| 300 ms++ | Node emite esse erro no busboy; ninguém está escutando → exceção não capturada → o processo encerra. |
Em produção, isso se parece com: "a requisição retornou um 400 limpo, e então o servidor reiniciou sem motivo." Esse atraso entre a resposta e o crash é o que torna o diagnóstico confuso.
Uma ideia anterior era fazer o busboy lançar uma exceção após o teardown com um cabeçalho de parte
malformado. Esse caminho é seguro: o erro é lançado sincronamente de dentro de
FileStream._read, que o Node envolve em um try/catch e reemite no file
stream — e o multer mantém um listener em cada file stream. A falha de _final é
diferente: ela é entregue através do callback Writable do busboy em um tick posterior,
emitida no próprio busboy, onde o listener já foi removido.
multer 2.5.0 mantém um listener de erro no-op no busboy após o teardown, para que um erro tardio
não possa mais se tornar uma exceção não 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 () {})
})
A requisição ainda termina com 400; a diferença é que o processo sobrevive.
| Data (2026) | Evento |
|---|---|
| 18 de out | Reportado de forma privada via GitHub Security Advisory (GHSA-q7qp-rjg7-q26m). |
| 18 de out | Triado como Alto pelos mantenedores. |
| 22 de out | [email protected] lançado com a correção. |
| 22 de out | CVE-2026-113872 publicado pela CNA da OpenJS Foundation. |