讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

FastAPI怎么在中间件中修改Request或Response数据

梦明姑娘_5614

梦明姑娘_5614

发布时间:2026-11-17 09:48:47

|

590人浏览过

|

来源于php中文网

原创

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

fastapi怎么在中间件中修改request或response数据

不能在 @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 字段。以下是一个生产可用的最小实现:

fastapi-pro
fastapi-pro

使用 FastAPI、SQLAlchemy 2.0 和 Pydantic V2 构建高性能异步 API。精通微服务、WebSocket 和现代 Python 异

下载
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 构造数据。

热门AI工具

更多
WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

咔片AIPPT

一款在线AI演示文稿制作工具,可根据主题和内容需求辅助生成PPT结构与页面,提高演示材料制作效率。

SoundView
SoundView Hot

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

相关专题

更多
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API
Python FastAPI异步API开发_Python怎么用FastAPI构建异步API

Python FastAPI 异步开发利用 async/await 关键字,通过定义异步视图函数、使用异步数据库库 (如 databases)、异步 HTTP 客户端 (如 httpx),并结合后台任务队列(如 Celery)和异步依赖项,实现高效的 I/O 密集型 API,显著提升吞吐量和响应速度,尤其适用于处理数据库查询、网络请求等耗时操作,无需阻塞主线程。

119

2025.12.22

Python 微服务架构与 FastAPI 框架
Python 微服务架构与 FastAPI 框架

本专题系统讲解 Python 微服务架构设计与 FastAPI 框架应用,涵盖 FastAPI 的快速开发、路由与依赖注入、数据模型验证、API 文档自动生成、OAuth2 与 JWT 身份验证、异步支持、部署与扩展等。通过实际案例,帮助学习者掌握 使用 FastAPI 构建高效、可扩展的微服务应用,提高服务响应速度与系统可维护性。

594

2026.02.06

Python Web框架FastAPI 全栈开发教程合集
Python Web框架FastAPI 全栈开发教程合集

以 FastAPI 为核心,讲解现代 Python Web API 的高效开发方式,涵盖路由定义与路径参数/查询参数/请求体绑定、Pydantic 模型的数据校验与序列化、依赖注入(Depends)系统的分层设计、中间件与 CORS 配置、OAuth2 + JWT 认证流程、后台任务(BackgroundTasks)、WebSocket 实时通信、SQLAlchemy 异步 ORM 集成、自动生成 OpenAPI/Swagger 交互文

776

2026.05.09

Python FastAPI异步微服务与高性能接口设计
Python FastAPI异步微服务与高性能接口设计

本专题聚焦 Python FastAPI 框架在高性能接口与微服务开发中的应用,讲解异步请求处理、依赖注入机制、路由设计、数据库异步操作以及接口性能优化策略。结合实际项目案例,帮助开发者构建高并发、低延迟的现代化后端服务架构。

679

2026.06.16

pycharm怎么改成中文
pycharm怎么改成中文

PyCharm是一种Python IDE(Integrated Development Environment,集成开发环境),带有一整套可以帮助用户在使用Python语言开发时提高其效率的工具,比如调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制。此外,该IDE提供了一些高级功能,以用于支持Django框架下的专业Web开发。php中文网给大家带来了pycharm相关的教程以及文章,欢迎大家前来学习和阅读。

3589

2023.07.25

pycharm安装教程
pycharm安装教程

PyCharm是一款由JetBrains开发的Python集成开发环境(IDE),它提供了许多方便的功能和工具。本专题为大家带来pycharm安装教程,帮助大家解决问题。

6817

2023.08.21

如何解决pycharm找不到模块
如何解决pycharm找不到模块

解决pycharm找不到模块的方法:1、检查python解释器;2、安装缺失的模块;3、检查项目结构;4、检查系统路径;5、使用虚拟环境;6、重启PyCharm或电脑。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

758

2023.12.04

如何安装pycharm
如何安装pycharm

安装pycharm的步骤:1、访问PyCharm官方网站下载最新版本的PyCharm;2、下载完成后,打开安装文件;3、安装完成后,打开PyCharm;4、在PyCharm的主界面中等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1034

2024.02.23

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn