在FastAPI中间件中无法直接修改响应体，必须通过StreamingResponse包裹加工后的字节流，并复制原响应的状态码和headers；因response.body只读且仅可读取一次，强行赋值或重复读取均无效。
中间件里怎么拿到并改写 FastAPI 的响应体？
直接改 response.body 是无效的——FastAPI 的 Response 对象在返回前已序列化，body 是只读属性。真正可行的方式是用流式响应或重写整个响应对象。
- 最稳妥的做法：在中间件中捕获原始响应，用
StreamingResponse包裹新内容，同时复制原响应头和状态码 - 不要试图修改
response.body或调用response.render()后再改——此时 body 已被编码，且可能已被 chunked 发送 - 若需 JSON 响应改造（比如统一加
data字段），建议在路由层处理；中间件更适合做日志、鉴权、CORS 等不侵入业务数据的操作
用 StreamingResponse 拦截并重写响应体的实操步骤
核心思路是把原响应转成字节流，读取全部内容，加工后再以流方式吐出。注意必须等完整响应生成后才能加工，所以会增加内存开销。
- 在中间件函数中，先 await 原
call_next(request)得到response - 调用
response.body（会触发render()）获取原始字节，例如：raw_body = await response.body() - 按需解码（如
raw_body.decode("utf-8")）、修改、再编码回 bytes - 构造新
StreamingResponse，传入迭代器（如[modified_bytes]），并显式设置status_code和headers - 务必复制原响应头：
headers=dict(response.headers)，否则可能丢失Content-Type或Content-Length
为什么不能在中间件里直接 await response.body() 两次？
因为 response.body() 是协程方法，首次调用会执行渲染逻辑并缓存结果；第二次调用虽不报错，但返回的是缓存值，无法反映你中途对 response 对象的任何改动（其实你也改不了）。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- FastAPI 的
Response子类（如JSONResponse）的body属性是 lazy-computed，且只计算一次 - 如果你在中间件里先
await response.body()，再尝试response.body = new_body，这个赋值会被忽略——body是只读 property - 更隐蔽的坑：某些自定义
Response类重写了render，但中间件无从感知，强行读 body 可能触发意外副作用
替代方案：用依赖注入 + Response 参数更安全地修改响应
如果目标只是统一包装 JSON 返回结构（比如加 {"code":0,"data":...}），中间件不是最优路径。用依赖注入配合 Response 参数更可控、无性能损耗。
立即学习“Python免费学习笔记（深入）”；
- 定义一个依赖函数，接收
response: Response和业务返回值，返回加工后的 dict - 在路由中声明该依赖，并让返回值经由它处理，例如：
@app.get("/user", dependencies=[Depends(wrap_response)]) - 这样既避免中间件的生命周期陷阱，又不破坏类型提示和 OpenAPI 文档生成
- 中间件适合跨域、日志、请求 ID 注入这类与响应体无关的操作；动 body 就得掂量是否真需要全局生效
