Initial commit
This commit is contained in:
commit
57fc3525eb
7311 files changed
+1291398
No files matched your search
@@ -0,0 +1,58 @@
|
||||
# 依赖升级计划(审查项 H6)
|
||||
|
||||
> 状态:**计划**,未修改 `requirements.txt`。编写日期 2026-09-25,分支 `fix/review-p1-p2-b`。
|
||||
> 审查原文:「`requirements.txt` 的 FastAPI/Uvicorn 约束偏旧;未证实特定 CVE 适用于当前依赖范围。使用锁定依赖与回归测试制定升级计划。」
|
||||
|
||||
## 1. 现状
|
||||
|
||||
| 包 | requirements.txt 约束 | 当前解析到的版本 | 最新(PyPI,2026-09) |
|
||||
|---|---|---|---|
|
||||
| fastapi | `>=0.100.0,<0.110.0` | 0.109.2 | 0.141.1 |
|
||||
| starlette(fastapi 间接依赖) | 未直接约束(fastapi 0.109 锁 `<0.37`) | 0.36.3 | 1.7.0 |
|
||||
| uvicorn[standard] | `>=0.23.0,<0.30.0` | 0.29.0 | 0.54.0 |
|
||||
| pydantic | `>=2.0.0,<3.0.0` | 2.13.4 | — |
|
||||
| python-multipart | 未安装 | — | — |
|
||||
|
||||
其余依赖(DrissionPage、requests、Pillow、regex……)都是开区间或宽区间,已经解析到较新版本,这次不动。
|
||||
|
||||
## 2. 已知公告是否适用(核对结论)
|
||||
|
||||
| 公告 | 影响范围 | 对当前依赖是否适用 |
|
||||
|---|---|---|
|
||||
| CVE-2025-62727 / GHSA-7f5h-v6xp-fcq8:`FileResponse` / `StaticFiles` Range 头二次复杂度 DoS(CVSS 7.5) | starlette `>=0.39.0,<0.49.1` | **不适用**:当前是 0.36.3,早于引入该问题的版本。**注意:升级时如果停在 0.39–0.49.0 就会中招**,下限必须 ≥ 0.49.1。 |
|
||||
| CVE-2025-54121:大文件 multipart 表单转存磁盘时阻塞事件循环 | starlette `<0.47.2` | 实际**不适用**:项目没安装 `python-multipart`,也没有 `UploadFile`/`Form` 端点,Starlette 无法解析 multipart 表单。 |
|
||||
| CVE-2024-47874:multipart 表单无大小限制导致 DoS | starlette `<0.40.0` | 同上,没有 multipart 解析能力,**实际不适用**。 |
|
||||
|
||||
结论与审查一致:目前**没有已证实可被利用的 CVE**。升级的主要价值是:(a) 避免长期停在无人维护的版本线;(b) 以后如果有人加文件上传端点,不会立刻踩中上面的 multipart 问题。
|
||||
|
||||
## 3. 升级试验(已做,环境已清理)
|
||||
|
||||
在临时 venv(`--system-site-packages`,只覆盖 web 栈)装 **fastapi 0.141.1 + starlette 1.7.0 + uvicorn 0.54.0**,跑与 CI 相同的非浏览器测试集:
|
||||
|
||||
- **750 项:686 通过 / 63 跳过 / 1 失败**(基线是当前锁定版本下 687 通过)。
|
||||
- 唯一失败:`tests/test_cancel_storm_regressions.py::test_asgi_send_interruption_closes_suspended_generator_before_return[send_error]`。
|
||||
原因:新版 Starlette 的 `collapsing_task_group` 直接抛出原始 `OSError`,不再包进 `ExceptionGroup`。
|
||||
测试后面的清理断言(生成器被关闭、`finish_request` 恰好调用一次)在新版下**全部成立**,业务行为没有回归,只是测试对异常类型的断言太严。
|
||||
→ 本提交已把断言放宽为 `pytest.raises((BaseExceptionGroup, OSError))`,新旧两个版本都能通过。
|
||||
- 用 `-W default::DeprecationWarning` 跑一遍,没有来自 fastapi/starlette/uvicorn 的弃用告警;代码里也没有用 `on_event`、`regex=`、`HTTP_422_UNPROCESSABLE_ENTITY` 这类在新版中被弃用的写法。
|
||||
|
||||
## 4. 建议步骤(分阶段,每步单独 PR)
|
||||
|
||||
1. **引入锁定文件**(不改变解析结果):用 `pip-compile`(或 `uv pip compile`)从 `requirements.txt` 生成 `requirements.lock`,CI 和发布包用 lock 安装;`requirements.txt` 仍保留宽约束,给源码用户用。
|
||||
2. **升级 web 栈**:
|
||||
```
|
||||
fastapi>=0.115.0,<0.142.0
|
||||
starlette>=0.49.1 # 明确下限,排除 CVE-2025-62727 的影响区间
|
||||
uvicorn[standard]>=0.30.0,<0.55.0
|
||||
```
|
||||
然后跑完整回归:`/tmp/runtests.sh` 等价的非浏览器测试集,加上作者本地的浏览器 E2E(`tests/browser_*.py`,需要 Chromium,本分支不跑)。
|
||||
3. **重点人工冒烟**(自动化测试覆盖不到的地方):
|
||||
- SSE 流式响应,以及客户端中途断开时的取消(`app/api/streaming_response.py`、`RequestStreamingResponse`),
|
||||
- `StaticFiles` / `FileResponse` 的 Range 请求(`/media/*` 音视频拖动进度条),
|
||||
- 重启代理 / handoff(S4/S5,`restart_proxy`)在新版 uvicorn 下的连接接管,
|
||||
- Windows 打包版(`pywin32`、uvicorn 的 `--reload` 不使用)。
|
||||
4. **以后如果要加上传端点**:同时显式加 `python-multipart>=0.0.18`,并在端点上设置请求体大小上限。
|
||||
|
||||
## 5. 回退
|
||||
|
||||
只有 `requirements.txt` / lock 文件的改动,回退就是还原这两个文件后重装依赖;代码层面不需要任何兼容分支(试验已证明当前代码在新旧版本下都能工作)。
|
||||
Reference in new issue
Block a user