fileFilter 进程崩溃单个未经身份验证的上传请求即可使任何使用 multer 且配置了异步 fileFilter 的 Express 应用的整个 Node.js 进程崩溃。该请求甚至会先收到正常的 400 响应;进程会在几百毫秒后终止。
| CVE | CVE-2026-113872 |
| GitHub 安全公告 | GHSA-q7qp-rjg7-q26m |
| 软件包 | multer(npm) |
| 受影响版本 | >= 2.0.0 < 2.5.0 |
| 修复版本 | 2.5.0 |
| 严重程度 | 高 — 7.5(CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H) |
| 类型 | 拒绝服务(未捕获异常)— CWE-248、CWE-404 |
| 报告者 | Santiago Habib(@santihabib) |
| 修复者 | Ulises Gascón、Sebastián Beltrán(expressjs/multer 维护者) |
本仓库是我所报告漏洞的详细说明,该漏洞现已公开披露并修复。概念验证针对的是已修补的版本,以便防御者确认自身是否受影响并验证修复效果。请升级至
[email protected]或更高版本。
如果以下所有条件均成立,则你受影响:
2.0.0 至 2.4.0;fileFilter 异步调用其回调——即在 await、setTimeout、数据库查询、HTTP 调用、病毒扫描等之后调用;.array()、.fields()、.any())。存储引擎(磁盘、内存、S3 等)以及所配置的 limits 均无影响。完全同步的 fileFilter 不受影响。
npm install multer@^2.5.0
保持 fileFilter 为同步执行,并将任何异步校验移至 multer 完成解析后运行的路由处理程序中。
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
针对存在漏洞的版本时的预期输出:
[server] listening on 31046
[client] HTTP 400 rejected
[check] VULNERABLE: server process exited with code 1 (Error: Unexpected end of form)
现在针对已修补的版本:
npm install [email protected]
node check.js
[server] listening on 32000
[client] HTTP 400 rejected
[check] NOT VULNERABLE: server is still running
相同的 payload,相同的 400 响应——但在 2.5.0 上,进程仍然存活。
multer 本身并不解析 multipart 请求体。它将请求管道传输给 busboy,并对其事件做出响应:
req ──pipe──▶ busboy ──'file'──▶ fileStream ──▶ storage engine
│
fileFilter(req, file, cb) ← your code, may be async
对于每个文件部分,busboy 会创建一个 Readable(fileStream)并发出 'file'。
multer 会询问你的 fileFilter 是否接受它。在调用 cb 之前,没有人
会读取该文件流。
multer 状态中有三个关键点:
errorOccured — 由第一个错误设置的闩锁;后续的中止操作会变成空操作。pendingWrites — 统计已被接受并正在存储的文件数。
其 fileFilter 仍处于待处理状态的文件不会被计入。done(err) — 结束请求:取消 busboy 的管道连接,调用 next(err),并在一个
setImmediate 之后调用 busboy.removeAllListeners()。当 busboy 将文件数据推入一个无人读取的流时,push()
返回 false。busboy 不会失败,而是暂停自己的写入回调,将其留在
文件流内部,等待有人读取它。与此同时,请求体的其余部分
继续到达,并在 busboy 的内部缓冲区中堆积为未解析状态。
被暂停的回调只有在文件流再次被读取时才会释放——此时 busboy 会排空其缓冲区并继续解析。
当先前的错误结束请求时,done() 会取消 busboy 的管道连接并调度
removeAllListeners()。但 unpipe 不会刷新 busboy 已经缓冲的内容,
而当仍处于待处理状态的 fileFilter 最终回调时,multer 会执行:
if (errorOccured) {
appender.removePlaceholder(placeholder)
return fileStream.resume() // ← reads the parked stream → busboy resumes
}
因此,在 teardown 之后,正是 resume() 让解析器重新苏醒。
两个文件部分,都带有异步过滤器。第一个在 100 ms 后拒绝;第二个在 300 ms 后接受。第二个文件大于 fileHwm(16 KiB),并且请求体没有以结束边界结尾。
| 时间 | 事件 |
|---|---|
| t0 | busboy 两次发出 'file';两个过滤器均处于挂起状态;pendingWrites == 0。 |
| t1 | 文件 2 填满其流 → busboy 暂停其写入回调;请求体的其余部分保持缓冲。 |
| t2 | req 结束;管道调用 busboy.end();终结操作在暂停的写入之后等待。 |
| 100 ms | 过滤器 1 拒绝 → 由于没有待处理项,done(err) 运行 → 客户端收到 400。 |
| 下一个 tick | setImmediate 移除 busboy 的监听器 —— busboy 现在没有 'error' 监听器。 |
| 300 ms | 过滤器 2 回调;errorOccured 已设置,因此 multer 调用 fileStream.resume()。 |
| 300 ms+ | busboy 排空其缓冲区并终结一个被截断的请求体 → Error('Unexpected end of form')。 |
| 300 ms++ | Node 在 busboy 上发出该错误;没有人在监听 → 未捕获异常 → 进程退出。 |
在生产环境中,这看起来像是:“请求返回了一个干净的 400,然后服务器无缘无故地重启了。” 响应与崩溃之间的那段延迟,正是它难以诊断的原因。
早先的一个想法是让 busboy 在 teardown 之后因格式错误的部分头部而抛出异常。那条路径是安全的:该错误是同步地从 FileStream._read 内部抛出的,Node 会将其包装在 try/catch 中,并在文件流上重新发出 —— 而 multer 在每个文件流上都保留了一个监听器。_final 失败则不同:它是在稍后的 tick 上通过 busboy 的 Writable 回调传递的,在 busboy 自身上发出,而那里的监听器已经被移除了。
multer 2.5.0 在 teardown 之后在 busboy 上保留一个空操作的错误监听器,因此迟到的错误不再会变成未捕获异常
(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 () {})
})
请求仍以 400 结尾;区别在于进程得以存活。
| 日期(2026 年) | 事件 |
|---|---|
| 10 月 18 日 | 通过 GitHub Security Advisory(GHSA-q7qp-rjg7-q26m)私下报告。 |
| 10 月 18 日 | 被维护者评定为高危。 |
| 10 月 22 日 | [email protected] 发布,包含修复。 |
| 10 月 22 日 | CVE-2026-113872 由 OpenJS Foundation CNA 发布。 |
本仓库中的代码依据 MIT 许可证 发布。它仅供教育和防御目的使用,针对的是一个已被修补的问题。