@ app.middleware("http") 无法修改 request body,因其接收的是已解析且只读的 Request 实例,body() 方法仅执行一次并缓存结果;真正篡改需介入 ASGI receive 协议。

不能在 @app.middleware("http") 里真正修改原始请求体(request body),因为此时请求已解析完毕、只读;但可以安全修改响应头、状态码、响应体内容,或通过底层 ASGI 中间件劫持并重写原始字节流。
为什么 @app.middleware("http") 无法修改 request body
FastAPI 的高层 HTTP 中间件接收的是已解析的 Request 实例,其 body() 方法只能调用一次,且返回的是缓存后的 bytes —— 即使你用 await request.body() 读取后尝试“伪造”新 body,后续路径操作仍会使用原始解析结果(如 Pydantic 模型绑定的仍是初始数据)。
- 常见错误现象:
request._body被手动赋值后,路径函数里item: Item依然解析旧数据 - 根本原因:Starlette 的
Request在首次调用body()后会把结果存在私有属性中,后续不再触发receive - 真正能篡改原始传输层数据的,只有介入 ASGI
receive协议的中间件
如何用 ASGI 中间件修改原始 request body
必须实现一个符合 ASGI 规范的 callable,包装 receive 函数,在 http.request 消息到达前替换 body 字段。以下是一个生产可用的最小实现:
import json
from typing import Callable, Awaitable, Any
<p>class ModifyRequestBodyMiddleware:
def <strong>init</strong>(self, app):
self.app = app</p><pre class="brush:php;toolbar:false;">async def __call__(self, scope, receive, send):
if scope["type"] != "http":
await self.app(scope, receive, send)
return
# 封装 receive,仅对 POST/PUT 等含 body 的方法生效
async def wrapped_receive():
message = await receive()
if message["type"] == "http.request" and message.get("more_body", False) is False:
# 只处理完整 body 已到达的情况(不支持流式分片)
try:
# 假设原始 body 是 JSON,解析后修改 value 字段
body = message.get("body", b"")
if body:
data = json.loads(body)
data["value"] = "456" # ✅ 真正修改了传输层数据
message["body"] = json.dumps(data).encode("utf-8")
message["headers"] = [
(b"content-length", str(len(message["body"])).encode("ascii"))
] + [h for h in message.get("headers", []) if h[0] != b"content-length"]
except (json.JSONDecodeError, UnicodeDecodeError):
pass # 非 JSON 或编码异常,跳过修改
return message
await self.app(scope, wrapped_receive, send)
- 必须在
app = FastAPI()之后、启动前注册:app.add_middleware(ModifyRequestBodyMiddleware) - 注意:该中间件会覆盖
content-length头,否则客户端或代理可能因长度不匹配而截断请求 - 不支持分片上传(
more_body=True场景),如需支持需缓存全部 chunk 再合成
如何在高层中间件中安全修改 response 数据
@app.middleware("http") 完全适合修改响应,包括状态码、头、甚至响应体内容(只要你不依赖原始响应对象的不可变性)。
- 修改响应头:
response.headers["X-Custom"] = "value" - 覆盖状态码:
response.status_code = 401(注意:若路径函数已返回Response(status_code=200),此处修改会生效) - 替换响应体(JSON 场景):
response.body = json.dumps({"msg": "overridden"}).encode(),但需同步更新content-length和content-type - ⚠️ 风险点:直接改
response.body后,若原响应用了StreamingResponse或自定义Response子类,可能破坏流逻辑
最常被忽略的是:ASGI 中间件修改 request body 后,Request 对象本身不会自动重新解析,路径函数里拿到的 request 仍是旧实例 —— 你得靠下游逻辑(比如手动 await request.json())才能看到新内容,或者干脆绕过 FastAPI 的自动解析,自己从 scope 和 receive 构造数据。


















