Python中FastAPI中间件如何拦截并修改响应？-Python教程-PHP中文网

在FastAPI中间件中无法直接修改响应体，必须通过StreamingResponse包裹加工后的字节流，并复制原响应的状态码和headers；因response.body只读且仅可读取一次，强行赋值或重复读取均无效。

python中fastapi中间件如何拦截并修改响应？

直接改 response.body 是无效的——FastAPI 的 Response 对象在返回前已序列化，body 是只读属性。真正可行的方式是用流式响应或重写整个响应对象。

最稳妥的做法：在中间件中捕获原始响应，用 StreamingResponse 包裹新内容，同时复制原响应头和状态码
不要试图修改 response.body 或调用 response.render() 后再改——此时 body 已被编码，且可能已被 chunked 发送
若需 JSON 响应改造（比如统一加 data 字段），建议在路由层处理；中间件更适合做日志、鉴权、CORS 等不侵入业务数据的操作

核心思路是把原响应转成字节流，读取全部内容，加工后再以流方式吐出。注意必须等完整响应生成后才能加工，所以会增加内存开销。

在中间件函数中，先 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

因为 response.body() 是协程方法，首次调用会执行渲染逻辑并缓存结果；第二次调用虽不报错，但返回的是缓存值，无法反映你中途对 response 对象的任何改动（其实你也改不了）。

让 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 可能触发意外副作用

如果目标只是统一包装 JSON 返回结构（比如加 {"code":0,"data":...}），中间件不是最优路径。用依赖注入配合 Response 参数更可控、无性能损耗。

定义一个依赖函数，接收 response: Response 和业务返回值，返回加工后的 dict
在路由中声明该依赖，并让返回值经由它处理，例如：@app.get("/user", dependencies=[Depends(wrap_response)])
这样既避免中间件的生命周期陷阱，又不破坏类型提示和 OpenAPI 文档生成
中间件适合跨域、日志、请求 ID 注入这类与响应体无关的操作；动 body 就得掂量是否真需要全局生效

实际改响应体这件事，多数时候是需求没分清「框架层」和「业务层」的职责边界。中间件一旦开始解析和重写 JSON，就等于承担了本该由视图函数完成的语义处理——后面加字段、做权限过滤、兼容老版本格式时，维护成本会快速上升。