本仓库通过测量来验证 CVE-2026-93687(GHSA-vfj7-8cjw-p6xm)中的说法,即 npm 包 braces 在 3.0.3 及以下版本中存在“通过深度嵌套模式导致栈耗尽”的漏洞(CWE-674,不受控递归)。该公告未列出任何已修复版本。
这是一个验证仓库,不是补丁仓库。它不会 fork 或修复 braces。它锁定确切的受影响版本,驱动每一个公共入口点,并报告数据。
深度嵌套的花括号模式(例如 {a,{a,{a,...}}} 或 {{{...}}})会使 braces 中的递归函数超出调用栈限制,抛出 RangeError: Maximum call stack size exceeded 并使进程崩溃。公告的引用指向 braces 3.0.3 中 lib/compile.js(L49-53)、lib/expand.js(L102-105)和 lib/parse.js(L38-40)的递归代码。
在 micromatch/braces 议题 #70 中,维护者(jonschlinkert,2026-10-05)称其为“完全是无稽之谈”,并提出了三点:
maxLength 设置在该值以下即可,而这已经得到支持。maxDepth 选项无法在总体上解决 glob DoS:glob 模式就是正则表达式,否定会迫使引擎构建并反转一个 DFA,而该状态空间可能呈指数级膨胀(星号高度问题)。自该议题开启以来,上游已收集了十二个修复 PR(#72 至 #89),其中五个仍处于开启状态,全部是对嵌套深度进行限制的各种变体。没有一个被合并。
机器:Apple Mac mini(Mac16,10),arm64,macOS 25.6(Darwin 25.6.0)。 Node:v26.8.1。braces 3.0.3、micromatch 4.0.8、fast-glob 3.3.1,均为精确锁定版本。
关于 braces 的两个事实决定了一切:
maxLength(lib/constants.js 中的 MAX_LENGTH)是 10000 个字符,而不是旧版本中的 65536。它在上游 PR #40(2024)中被降低到 10000。lib/parse.js 将有效上限设置为 Math.min(MAX_LENGTH, opts.maxLength)。因此 maxLength 只能降低 10000 的上限,永远无法提高或禁用它。braces 不会接受超过 10000 个字符的输入。parse 也是迭代式的(使用显式的 stack 数组),因此它从不递归,也从不溢出;递归存在于 expand 和 compile 中。因此问题在于,10000 个字符或更少的模式是否嵌套得足够深,以致溢出递归的 expand/compile。答案取决于调用是冷还是热,而这关系重大:
因此,下面的每个探测都在其自己的全新 node 进程中运行(repro/child.mjs 通过 spawnSync):一次构建、一次调用、打印结果。warm 列在单个进程内重复相同的搜索,以展示差距。结果:stack(捕获到的 RangeError)、guarded(长度守卫先拒绝了它)、other(捕获到的其他错误,例如 V8 的“regex too large”)、ok。
形状:commaNested = {a,{a,...}}(每层约 4 个字符),braceNested = {{{...a...}}}(每层约 2 个字符),rangeNested = {1..2,{1..2,...}}(每层约 7 个字符)。maxLength 默认值 = 10000。
| 入口点 | 形状 | 冷启动崩溃深度 | 模式长度 | 冷启动 | 热启动 |
|---|---|---|---|---|---|
| braces() | commaNested | 2500 | 10001 | 受保护 | 受保护@2500 |
| braces() | braceNested | 3510 | 7021 | 栈溢出 | 受保护@5000 |
| braces() | rangeNested | 1429 | 10007 | 受保护 | 受保护@1429 |
| braces.expand() | commaNested | 2500 | 10001 | 受保护 | 受保护@2500 |
| braces.expand() | braceNested | 3984 | 7969 | 栈溢出 | 受保护@5000 |
| braces.expand() | rangeNested | 1429 | 10007 | 受保护 | 受保护@1429 |
| braces.compile() | braceNested | ~3500 | ~7000 | 栈溢出(临界) | 受保护@5000 |
| braces.parse() | braceNested | 5000 | 10001 | 受保护 | 受保护@5000 |
| micromatch() | commaNested | 5653 | 22613 | 其他(正则表达式过大) | 相同 |
| micromatch() | braceNested | 16383 | 32767 | 其他(正则表达式过大) | 相同 |
| micromatch() | rangeNested | 9362 | 65538 | 受保护 | 相同 |
| micromatch.isMatch() | braceNested | 16383 | 32767 | 其他(正则表达式过大) | 相同 |
| fast-glob.generateTasks() | braceNested | ~3976 | ~7953 | 栈溢出(临界) | 受保护@5000 |
| fast-glob.sync() | braceNested | 128 | 257 | 其他(良性的 glob Error) | 相同 |
| (所有 braces/fast-glob) | commaNested / rangeNested | 2500 / 1429 | ~10000 | 受保护 | 受保护 |
解读表格:
braces() 和 braces.expand() 在花括号形状下、模式长度约 7000 到 8000 字符时就会栈溢出,远低于 10000 的上限。 这在多次全新运行中都是确定性的(在深度 4000、长度 8001 时,两者均确认 5/5 次复现)。编译路径和 fast-glob.generateTasks 处于相同的冷启动阈值区间(约深度 3500 到 4000);恰好在临界点附近,精确深度在多次运行间会有几百的波动,但再深几百就是可靠的崩溃。braces.parse() 从不溢出(它是迭代式的),在任何形状下都是如此。MAX_LENGTH = 65536)并自行处理花括号;在该上限以下,它会构建一个大到 V8 抛出可捕获的 SyntaxError: Invalid regular expression ... too large 的正则表达式。长模式不会被转发到 braces 的栈溢出中。picomatch 与 braces 是不同的包。fast-glob.sync()(在临时目录上执行真实 glob)不是 DoS 向量:它很早就抛出一个普通的、可捕获的 Error(深度 128),而不是栈溢出。模式解析路径 generateTasks 才是可能触及递归的那一个。在每个崩溃案例中,溢出都是一个 RangeError,会被外层的 try/catch 捕获;子进程打印其结果并以 0 退出,因此它是一个被抛出的错误,而不是不可捕获的中止。没有数据泄露,也没有代码执行。
expand/compile 直接接受 AST 对象,绕过了长度保护。手工构建的嵌套 AST 会在栈允许的任何深度溢出(默认栈热启动时约 6200,--stack-size 更大时更高,更小时更低)。因此递归本身没有边界;唯一阻止它崩溃的是 10000 字符的输入上限,而在花括号形状下,该上限在冷启动时并不足够。
按形状测量冷启动时,第一个崩溃长度以及拒绝它的 maxLength:
| 形状 | 首次冷崩溃长度 | 安全 maxLength |
|---|---|---|
braceNested, braces() | 约 7001(3 次运行中有 2 次在长度 7001 时崩溃,从 7201 起每次运行都崩溃) | 6800 |
braceNested, braces.expand() | 7965 | 7964 |
| commaNested | (在上限处被防护) | 10000 |
| rangeNested | (在上限处被防护) | 10006 |
关键案例是花括号形状上的 braces() 本身:它首次崩溃于长度 7001,而在 6801 时从未崩溃(各 3 次全新运行),因此在这台机器上,全局安全的冷 maxLength 约为 6800。一个远低于该值的舒适整数值 maxLength: 4096 经冷验证可将崩溃转化为被捕获的 guarded 错误。
在冷状态下测量——即真实服务器在首次收到恶意请求时所处的状态——该 CVE 的核心主张在默认配置下成立。使用默认选项和默认 Node 栈时,一个约 7000 字符的不可信花括号模式(远低于随附的 10000 字符上限)会在全新进程中使 braces() 和 braces.expand() 崩溃,并抛出 RangeError: Maximum call stack size exceeded。因此“默认 maxLength 已解决该问题”对花括号形状并不成立;维护者关于 10001 字符的论点仅适用于逗号形状。话虽如此,维护者对根本原因和修复方法的判断是正确的:将不可信 glob 传给 glob 或正则库才是真正的错误,而降低 maxLength(在这台机器上约 6800 或更低,保险起见用 4096)可封堵可达路径。影响是拒绝服务式的进程崩溃,可通过 try/catch 捕获,不涉及数据泄露或代码执行。micromatch 和真实的 fast-glob glob 调用会以其他可捕获的方式失败,而非栈溢出。净结论:报告者的核心技术主张得到确认,且在一种模式形状下于默认上限处可达;维护者规定的缓解措施真实有效,一旦应用即足够。
参见 mitigations/example.mjs。
maxLength。 如果你必须在不能完全控制的输入上运行 braces/micromatch,请传入较小的 maxLength(在这台机器上 4096 是安全的;实测冷上限约为 6800)。它会抛出可捕获的错误,而不是递归。micromatch 会将 maxLength 转发给 braces(已验证)。fast-glob 不暴露该选项。braces 仅作为传递依赖出现时,将其从依赖树中移除。 在我们的应用(Pargus)中,braces 仅通过 @next/eslint-plugin-next -> fast-glob -> micromatch -> braces 引入,这是一条仅用于开发的 ESLint 路径,调用 globSync(pattern, { onlyDirectories: true })。我们添加了 pnpm override:"@next/eslint-plugin-next>fast-glob": "npm:tinyglobby@^0.2.17",从而将 braces 和 micromatch 从依赖树中移除。前后 lint 输出完全一致。maxLength 限制了影响范围;它并不能使任意用户提供的 glob 变得安全(参见维护者关于星号高度的观点)。需要 pnpm。
pnpm install
pnpm repro # node repro/repro.mjs : cold crash vs warm survival, and the mitigation
pnpm measure # node repro/measure.mjs : the cold/warm table above (spawns a process per probe)
pnpm test # node --test : asserts the cold findings
上述数字是在 Node v26.8.1、Apple Mac mini(Mac16,10)、arm64、macOS 25.6 上测得的。具体阈值会随 Node 版本、CPU 和栈大小而变化;但结果的形态(花括号形态在限制下冷启动即崩溃,逗号和范围形态不会,parse 和 micromatch 从不发生栈溢出)不会改变。
MIT,版权所有 (c) 2026 Can Ozmen。参见 LICENSE。