针对 23 个 io.netty:netty-codec-http 安全公告(2025–2026)的离线检查工具 —— 其中 14 个 CVE 收录于
GitHub Advisory Database,另外 9 个是 Netty 于 2026-09-10 仅在其自有仓库中发布、Dependabot 无法看到的
安全公告。
它会告诉你实际暴露于哪些漏洞,以及能一次性清除全部漏洞的单一版本:
4.1.138.Final / 4.2.18.Final。
⚠️ 对 v0.1.x 的更正。 本工具的 0.1.x 版本(及其 README)曾称
4.1.137.Final/4.2.17.Final可清除所有问题。该结论已过时。 在撰写时它对当时存在的 14 个安全公告是正确的;2026-09-10 发布的一批公告 将目标版本上调了一个补丁版本。在4.1.137.Final/4.2.17.Final上,你仍会暴露于 新公告中的 8 个,其中包括一个评级为 high 的漏洞(GHSA-pvjx-v7vp-62vq,见下文)。 如果你是因 v0.1.x 的建议而升级,请再升级一次。
单个 jar,零运行时依赖,完全离线,Java 17+。
GitHub Advisory Database 中的 14 个 CVE(Dependabot 会针对这些发出告警):
CVE-2025-58056 · CVE-2025-67735 · CVE-2026-33870 · CVE-2026-41417 · CVE-2026-42580 · CVE-2026-42581 · CVE-2026-42585 · CVE-2026-42587 · CVE-2026-50020 · CVE-2026-56746 · CVE-2026-59898 · CVE-2026-59899 · CVE-2026-59903 · CVE-2026-59921
9 个仅存在于仓库的安全公告,于 2026-09-10 发布于 netty/netty(尚无 CVE ID;Dependabot 不会针对这些发出告警):
| 安全公告 | 严重程度 | 内容 | 修复版本 |
|---|---|---|---|
GHSA-pvjx-v7vp-62vq | high | HttpServerCodec:通过 HTTP/1.1 流水线导致每连接队列无上限 → 堆内存耗尽 | 4.1.138 / 4.2.18 |
GHSA-2g6j-r8q9-5hr8 | high(CVSS 7.3) | HttpServerCodec 响应不同步 | 4.1.137 / 4.2.17 |
GHSA-2g37-3h88-55hc | medium | WebSocketServerExtensionHandler:通过流水线导致每连接队列无上限 | 4.1.138 / 4.2.18 |
GHSA-3jrc-fchc-59pw | medium | Transfer-Encoding 拆分到多个头字段可绕过最终 chunked 检查 → 请求走私 | 4.1.138 / 4.2.18 |
GHSA-hcvj-94mj-jp5c | medium | 对畸形 Transfer-Encoding 的校验不完整(绕过先前修复)→ 请求走私 | 4.1.138 / 4.2.18 |
GHSA-j4mg-hqgv-34qc | medium | chunk-size 中数字后的空白被截断 → 请求走私 | 4.1.138 / 4.2.18 |
GHSA-rq4j-fc47-9698 | medium | chunk-size 行中的控制字符 → 请求走私 | 4.1.138 / 4.2.18 |
GHSA-h75q-xqrh-59rf | medium | RtspDecoder 方法令牌带有尾部控制字节 | 4.1.138 / 4.2.18 |
GHSA-rmcw-9fcq-wjq7 | medium | SpdySessionHandler 接受无限并发远程流 → OOM | 4.1.138 / 4.2.18 |
在工具输出中,这九个中的每一个都标记为 [Dependabot/全局库:未收录]
(“未收录于 GitHub Advisory Database”)。
Dependabot 告警来自 GitHub Advisory Database。2026-09-10,Netty 在其自有仓库
(netty/netty → Security → Advisories)中发布了一批安全公告。截至 2026-09-19,
影响 netty-codec-http 的九个公告中没有一个收录于 GitHub Advisory Database ——
对其中每一个执行 gh api advisories/<GHSA-ID> 都返回 404,而一个已知条目
(GHSA-8c42-7qj2-3j46)作为对照返回 200。它们都尚无 CVE ID。
因此,一个被 Dependabot 报告为在 4.1.137.Final 上干净的项目,实际上仍处于其中八个的
受影响范围内。
GHSA-pvjx-v7vp-62vq 是默认路径上的那个。 它位于 HttpServerCodec 中,即几乎所有 Netty HTTP/1.1 服务器都会使用的请求解码器/响应编码器对。一个远程、未认证的客户端在单个连接上流水线发送大量请求且不读取响应;每连接的方法队列会无限制增长,直到堆内存耗尽。无需任何特殊配置。评级为 high;该公告未公布 CVSS 评分。GHSA-2g6j-r8q9-5hr8 需要同时满足三个条件:HTTP/1.1 流水线、流水线中存在 HEAD 请求,以及客户端发送 Expect: 100-continue。只有在这种情况下,才可能为一个请求丢弃响应体而为另一个请求发送响应体。评级为 high(CVSS 7.3),但它不是默认路径问题。它已在 4.1.137.Final / 4.2.17.Final 中修复,因此 v0.1.x 的答案已经覆盖了它。3jrc、hcvj、j4mg、rq4j)属于解析器差异问题。当 Netty 位于另一个以不同方式解析同一畸形消息的 HTTP 组件之后或之前时,它们才会产生影响。2g37、h75q 和 rmcw 仅在你分别使用 WebSocket 扩展(例如 WebSocketServerCompressionHandler)、RtspDecoder 或 SPDY 时才适用。每个 Netty 模块都以相同的版本号发布,因此升级感觉像是一个单一决策。事实并非如此。在这 23 个公告中,4.1 分支的修复版本落在 125 / 129 / 132 / 133 / 135 / 136 / 137 / 138 —— 八个不同的值。只遵循任何一个公告,你仍然处于其他公告的影响范围内。
netty-codec-http2 将 netty-codec-http 声明为 compile 依赖,并使用 <version>${project.version}</version> —— 两个版本被固定在一起。
因此,如果你因为 4.1.136.Final 是清除七个 netty-codec-http2 CVE 的版本而升级到它,你现在运行的 netty-codec-http 也是 4.1.136.Final。这仍处于 CVE-2026-59903(<= 4.1.136.Final)和所有九个仅仓库公告的范围内。你需要 4.1.138.Final。在 4.2 分支上,HTTP/2 的答案是 4.2.16.Final;这一侧需要 4.2.18.Final。
这并不是说 HTTP/2 的建议有误——它是针对另一个模块给出的答案。而是说 “一个版本号”掩盖了你只为一个模块作答的事实。
<= 16 次,写作 < 12 次。因此同一个 4.1.136.Final 对 CVE-2026-56746(< 4.1.136.Final)是安全的,而对 CVE-2026-59903(<= 4.1.136.Final)是受影响的。无论以哪种方式规范化运算符都会给出错误答案,因此每个运算符都完全按照发布时的原样保留。GHSA-3jrc-fchc-59pw 只发布了下界(>=4.1.132.Final / >=4.2.12.Final)。按字面理解,即使是已修复的 4.1.138.Final 也会被视为“受影响”。生成器仅为该公告添加已发布的修复版本作为显式上界,并在旁边打印原始范围,如果任何其他范围会被改动则报错。pom.xml如果你使用 Spring WebFlux,netty-codec-http 会通过
spring-boot-starter-webflux
-> spring-boot-starter-reactor-netty
-> reactor-netty-http
-> netty-codec-http
artifactId 永远不会出现在你的 pom.xml 中。 基于 pom 的检查会回答“我没有使用它”,这是错误的。此工具读取实际发布的 jar 包。
java -jar netty-http-check.jar target/ # scan build output
java -jar netty-http-check.jar myapp.jar # Spring Boot fat-jar / war, nested jars included
java -jar netty-http-check.jar --version-of 4.1.137.Final # judge a version directly
| 代码 | 含义 |
|---|---|
0 | 扫描完成,每个文件都确实被读取,且 23 条均不适用 |
1 | 受 23 条中至少一条影响 |
2 | 无法判断(参数错误、路径不存在、未找到 netty-codec-http、版本无法解析) |
4 | 部分文件无法读取——不是 zip、被截断或 I/O 失败 |
🔴 2 被刻意设为不等于 0:“未发现任何问题”和“干净”对脚本而言绝不能看起来一样。
🔴 4 于 2026-09-09 添加。 在此之前,无法读取的文件只会在 stdout 上输出一行,而退出码仍保持 0——因此在 CI 中,“我无法读取它”会静默地意味着“通过”。
“我无法读取它”和“你是安全的”必须是两句不同的话。 如果发现了受影响项,1 优先于 4。
⚠️ 合法的空 jar(仅含 22 字节 EOCD 记录)是真正的空 zip,而非损坏文件,不会触发 4——误报正是让真实告警被忽视的原因。
netty-codec-http。 其他 Netty 模块有自己的公告(2026-09-10 批次还涵盖 netty-codec-http2、-http3、-stomp、-smtp、-mqtt 等);此处结果干净并不代表它们没有问题。如果你还运行 netty-codec-http2,工具会提示这一点并指向上述跨模块问题,但它不会判断该模块。high 级别的 GHSA-pvjx-v7vp-62vq);它们按原样打印,不会被汇总成一个吓人的总分。src/main/java/dev/mikko/nettyhttpcheck/RuleTable.java 是生成的,从不手工编辑:
python tools/gen_rules.py --dry # run the assertions only
python tools/gen_rules.py # regenerate the table
十条断言必须全部通过,否则不会写入任何内容。其中包括:14 条全局公告仍为 reviewed;netty-codec-http 的 2026-09-10 仓库批次仍恰好是这九条,且仍不在 GitHub Advisory Database 中(并带有一个必须返回 200 的正向对照);计算得出的唯一答案仍为 4.1.138.Final / 4.2.18.Final,且可从 Maven Central 获取(并带有一个必须返回 404 的哨兵版本);旧版 v0.1.x 的答案 4.1.137.Final / 4.2.17.Final 仍会命中 GHSA-pvjx-v7vp-62vq;仅含下界的范围已被处理,且没有修改其他范围;< / <= 边界情况仍会翻转;并且 §4 中的 HTTP/2 答案在这一侧仍留下一个漏洞。
tools/recheck_before_publish.py 会在任何报告发布前重新检查已发布的声明;如果这九条公告出现在 GitHub Advisory Database 中、如果 4.1.138.Final / 4.2.18.Final 从 Central 中消失,或者如果 4.1.139.Final / 4.2.19.Final 出现(更新的发布可能意味着更新的公告),它就会以 3 退出。
真实 jar 的端到端检查位于 tools/e2e_real_jars.py —— 它们从 Maven Central 下载实际的 jar(包括 4.1.137、4.1.138、4.2.17、4.2.18),而不是使用测试夹具,因为“在手工构建的 zip 上能工作,在真实 jar 上却失败”是一种真实的失败模式。
Apache License 2.0 —— 参见 LICENSE。