导语:AIOHTTP WebSocket 队列绕过漏洞(CVE-2026-128132)以 CVSS 8.7 的高危评分敲响了异步 Web 框架背压机制的警钟——攻击者只需发送大量小消息或精心构造的 permessage-deflate 压缩帧,就能让接收队列的限流形同虚设,在服务端堆出数 MB 的解压消息,最终触发内存耗尽。作为长期维护高并发网关的架构师,我认为这不是一个孤立的补丁问题,而是“帧解析与流控解耦”这一经典设计缺陷在压缩场景下的集中爆发。
企业级架构规范
flowchart TD
subgraph 接入层 ["接入层与传输层 (Transport Tier)"]
A["客户端 WebSocket 连接"] --> B["TCP Transport 读取缓冲区"]
end
subgraph 解析层 ["帧解析与解压层 (Frame Parser Tier)"]
B --> C["WebSocketReader 帧循环解析"]
C --> D["permessage-deflate 解压器"]
end
subgraph 队列层 ["接收队列与背压层 (Queue & Backpressure Tier)"]
D --> E["接收队列 (max_queue 限流)"]
E --> F{"队列是否已满?"}
F -- "已满" --> G["暂停 Transport (pause_reading)"]
F -- "未满" --> H["入队并通知消费协程"]
end
subgraph 消费层 ["应用消费层 (Consumer Tier)"]
H --> I["业务协程 async for 消费消息"]
G --> J["漏洞点: 已收帧继续解析 / 空消息不计入队列"]
J --> E
end
一、漏洞全景:AIOHTTP WebSocket 队列绕过到底绕过了什么
先给结论:这个漏洞的本质不是“缓冲区溢出”式的经典内存破坏,而是流控语义与解析语义的错位。AIOHTTP 的 WebSocket 服务端通过一个带容量上限的接收队列(默认由 max_queue 控制)来实现背压——当队列满时,调用 transport.pause_reading() 暂停底层 TCP 读取,从而让内核接收窗口收缩,反压到发送端。
问题出在两个细节上,官方公告说得很克制,但从架构视角看非常致命:
- 已接收帧继续解析:当队列触发暂停后,
WebSocketReader并没有立即停止对“已经读入内存的帧数据”的解析循环,而是继续把帧解出来塞进队列。也就是说,暂停的是 Transport,不是解析器。 - 空消息不计入队列大小:空消息(empty message)在入队时没有被计入队列容量。攻击者可以发送海量空帧,队列长度看起来永远是 0,限流完全失效。
- 压缩帧的内存放大:开启
permessage-deflate后,一次读取的压缩帧可能解压出远超原始字节数的消息。攻击者用高压缩比的小帧,就能在单次读取中向队列注入数 MB 的解压消息。
CVSS 8.7 属于高危。攻击者无需认证即可通过“小消息洪泛 + 压缩炸弹”组合,让 WebSocket 服务端内存持续增长直至 OOM。对于面向公网的实时推送网关、在线协作服务、IM 长连接集群,这是可直接导致节点雪崩的攻击面。
二、源码级拆解:AIOHTTP WebSocket 队列绕过的三处缺陷
2.1 缺陷一:pause_reading 之后的解析循环未中断
在 AIOHTTP 的 web_ws.py 中,WebSocketReader.read() 负责从 Transport 读取数据并驱动帧解析。当接收队列达到 max_queue 时,代码会调用 self._transport.pause_reading()。但解析循环的退出条件绑定的是“当前缓冲区是否还有完整帧”,而不是“队列是否已满”。因此,只要内核缓冲区里还有数据(在高吞吐攻击下几乎总是有),解析器就会继续工作。
从架构上看,这是典型的控制面与数据面耦合不足:背压信号只作用于 I/O 层,没有向上传递到解析层。正确的做法是在每次帧解析前检查队列水位,一旦超过阈值立即 break,把剩余字节留在缓冲区,等消费端腾出空间后再恢复。
2.2 缺陷二:空消息绕过队列容量统计
队列容量统计通常基于“消息条数”或“消息字节数”。AIOHTTP 的实现中,空消息(payload 长度为 0 的文本/二进制帧,或 ping/pong 控制帧的变体)在入队路径上没有递增计数器。攻击者构造大量空帧,每条消息的内存开销虽小,但协程调度、队列节点、事件循环回调的开销是实打实的。更关键的是,它让 max_queue 这道防线彻底失效,为后续的压缩帧攻击打开了闸门。
2.3 缺陷三:permessage-deflate 解压发生在入队之前
这是内存放大的核心。压缩帧的解压发生在帧解析阶段、入队之前。攻击者发送一个几十字节的压缩帧,解压后可能是几百 KB 甚至数 MB 的文本。由于缺陷一让解析循环不中断,单次 read() 就能连续解压多个这样的帧,把数 MB 的解压消息一次性堆进队列。此时 max_queue 的条数限制根本拦不住——因为限制的是条数,不是字节数。
WebSocket 接收队列的限流必须同时具备“条数上限”和“字节上限”两个维度,且压缩解压后的字节数必须计入配额。只按条数限流,在压缩场景下等于没有限流。
三、攻击面评估:谁在风险之中
| 部署场景 | 是否默认开启压缩 | 风险等级 | 攻击后果 |
|---|---|---|---|
| 公网 WebSocket 推送网关 | 视配置而定 | 高危 | 节点 OOM,长连接集体断开 |
| 在线协作 / IM 服务 | 常开启 permessage-deflate | 高危 | 内存放大 10-100 倍,快速打满 |
| 内网微服务间 WebSocket | 通常关闭 | 中危 | 空消息洪泛仍可耗尽队列 |
| AIOHTTP 作为 WebSocket 客户端 | 视服务端协商 | 中高危 | 恶意服务端可反向打爆客户端内存 |
需要特别提醒的是,公告明确指出“恶意服务器可针对客户端”发起攻击。这意味着即使你的服务端配置得当,只要你的 AIOHTTP 客户端连接了不可信的对端,同样会中招。在微服务网关、爬虫、第三方 WebSocket 接入等场景中,这个方向的风险常被低估。
四、工业级修复方案:从补丁到纵深防御
4.1 第一优先级:升级到修复版本
官方补丁提交为 0ae507423f681161efa77d20052b4054397c7fb6,核心改动是在帧解析循环中引入队列水位检查,并将空消息与解压后字节数纳入队列统计。生产环境应立即升级到包含该提交的 AIOHTTP 版本。
点击展开:升级命令与版本校验脚本
# 查看当前版本 python -c "import aiohttp; print(aiohttp.__version__)" # 升级到修复版本(请以官方公告确认的最低修复版本为准) pip install --upgrade "aiohttp>=3.12.0" # 校验 python -c "import aiohttp; print(aiohttp.__version__)"
4.2 第二优先级:收紧 WebSocket 服务端配置
在无法立即升级的窗口期,或作为纵深防御,应显式收紧接收队列与压缩策略。AIOHTTP 的 WebSocketResponse 支持 max_msg_size、compress、max_queue 等参数,合理组合可大幅压缩攻击面。
from aiohttp import web, WSMsgType
async def ws_handler(request):
ws = web.WebSocketResponse(
max_msg_size=64 * 1024, # 单条消息硬上限 64KB,阻断压缩炸弹
max_queue=8, # 队列条数上限,降低积压
compress=False, # 非必要不开启 permessage-deflate
autoping=True,
heartbeat=30.0,
)
await ws.prepare(request)
async for msg in ws:
if msg.type == WSMsgType.TEXT:
# 业务处理:务必快速消费,避免队列积压
await handle_text(msg.data)
elif msg.type == WSMsgType.ERROR:
break
return ws
max_msg_size 限制的是解压后的消息大小,但不同版本行为存在差异。升级后务必用压缩帧做一次回归压测,确认超限消息被正确拒绝而非静默截断。另外,关闭 compress 会牺牲带宽,对移动端弱网场景需权衡。
4.3 第三优先级:运行时可观测与熔断
补丁和配置是静态防御,运行时监控才是最后一道闸。建议在 WebSocket 连接层埋点:接收队列长度、单连接累计解压字节数、消息消费延迟。当单连接解压字节数超过阈值或队列持续高位时,主动关闭连接并记录攻击指纹。
import time
from aiohttp import web, WSMsgType
MAX_DECOMPRESSED_BYTES = 8 * 1024 * 1024 # 单连接累计解压上限 8MB
async def ws_handler(request):
ws = web.WebSocketResponse(max_msg_size=64 * 1024, max_queue=8, compress=False)
await ws.prepare(request)
total = 0
start = time.monotonic()
async for msg in ws:
if msg.type == WSMsgType.TEXT:
total += len(msg.data.encode("utf-8"))
if total > MAX_DECOMPRESSED_BYTES:
await ws.close(code=1009, message=b"payload too large")
break
await handle_text(msg.data)
elif msg.type == WSMsgType.ERROR:
break
elapsed = time.monotonic() - start
if elapsed MAX_DECOMPRESSED_BYTES // 2:
# 短时间高吞吐,疑似洪泛攻击,记录指纹
log_suspicious(request.remote, total, elapsed)
return ws
五、架构反思:异步框架背压设计的通用教训
AIOHTTP WebSocket 队列绕过漏洞给所有异步框架的维护者上了一课。我在多个高并发网关项目中反复验证过一条原则:背压必须是端到端的,任何一层“暂停”都必须向上游传递,且计量单位必须覆盖真实资源消耗。
- 暂停 I/O 不等于暂停解析:Transport 层的 pause 只是第一道闸,解析器必须有独立的退出条件。
- 按条数限流是伪限流:消息大小方差极大,必须同时限制字节数,压缩场景下要限制解压后字节数。
- 压缩是双刃剑:permessage-deflate 节省带宽,但把“小输入大输出”的放大能力交给了攻击者。对不可信对端,默认关闭压缩是更安全的选择。
- 客户端同样需要防御:不要假设服务端可信,AIOHTTP 客户端连接第三方 WebSocket 时应复用同样的队列与大小限制。
在网关层统一实现 WebSocket 连接的资源配额(连接数、单连接解压字节、消息速率),比在每个业务 Handler 里重复配置更可靠。配额应由基础设施层强制,业务层无感知。
六、修复验证清单与回归测试
完成升级与配置调整后,建议按以下清单验证,确保 AIOHTTP WebSocket 队列绕过漏洞被真正封堵:
| 验证项 | 方法 | 预期结果 |
|---|---|---|
| 空消息洪泛 | 发送 10 万条空文本帧 | 队列达到 max_queue 后暂停读取,内存平稳 |
| 压缩炸弹 | 发送高压缩比 deflate 帧 | 解压后超过 max_msg_size 被拒绝 |
| 队列水位 | 消费端故意延迟 | Transport 暂停后解析器同步停止 |
| 客户端方向 | 模拟恶意服务端推送 | 客户端内存不增长,连接被主动关闭 |
最后强调一点:安全公告的价值不在于“打个补丁就完事”,而在于借机审视自己的背压模型。AIOHTTP WebSocket 队列绕过漏洞暴露的“解析与流控解耦”问题,在自研协议、消息中间件、RPC 框架中同样普遍存在。把这次修复当作一次架构体检的契机,远比被动升级更有价值。
本文核心技术背景源自 GitHub Security Advisory 官方公告:
GHSA-5rmc-48h2-hvcm / CVE-2026-128132 (aio-libs/aiohttp)
官方修复提交:commit 0ae5074
