python
runtime_error
ai_generated
true
运行时错误：文件响应已启动。
RuntimeError: File response is already started
ID: python/fastapi-file-response-error
80%修复率
83%置信度
0证据数
2026-03-05首次发现
版本兼容性
| 版本 | 状态 | 引入 | 弃用 | 备注 |
|---|---|---|---|---|
| 3.x | active | — | — | — |
根因分析
尝试在响应已经开始发送后再次修改或发送文件。
English
尝试在响应已经开始发送后再次修改或发送文件。
解决方案
-
95% 成功率
确保只返回一次 `FileResponse`，不要在返回后修改。
-
85% 成功率
使用 `StreamingResponse` 并正确管理生成器生命周期。
无效尝试
常见但无效的做法:
-
70% 失败
尝试在返回 `FileResponse` 后继续写入响应，导致错误。
-
60% 失败
尝试在流式响应中使用 `yield` 但未正确管理生成器。