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

梦明姑娘_5614

梦明姑娘_5614

2026-11-17

590人浏览

原创

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

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)

fastapi-pro
fastapi-pro

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

下载
  • 必须在 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 构造数据。

大量免费API接口:立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游,为数据API应用能力赋能!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

fastapi

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2025.12.22

119

5

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

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

2026.02.06

594

18

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

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

2026.05.09

776

23

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

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

2026.06.16

679

12

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

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

2023.07.25

3589

3

pycharm安装教程
pycharm安装教程

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

2023.08.21

6817

4

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

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

2023.12.04

758

5

如何安装pycharm
如何安装pycharm

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

2024.02.23

1034

5

python和pycharm的区别
python和pycharm的区别

Python和PyCharm是两个不同的概念,它们的区别如下:1、Python是一种编程语言,而PyCharm是一款Python集成开发环境;2、Python可以运行在各种不同的开发环境中,而PyCharm是专门为Python开发而设计的IDE等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

527

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程