讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

Seko
Seko

AI短剧一键生成成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Starlette如何实现中间件Middleware

风宇同学_5008

风宇同学_5008

发布时间:2026-11-18 11:44:29

|

647人浏览过

|

来源于php中文网

原创

starlette 通过依赖注入和装饰器模式实现中间件,核心机制是将每个中间件类包装成 asgi 应用,并在请求到达最终路由前依次执行。开发者只需继承 starlette.middleware.base.basehttpmiddleware 或实现标准 asgi 接口,即可在 starlette 实例中通过 add_middleware 方法注册。这些中间件按注册顺序组成调用链,请求从外向内传递,响应从内向外返回。

Starlette如何实现中间件Middleware

如何自定义一个基于 BaseHTTPMiddleware 的中间件

使用 BaseHTTPMiddleware 可以简化中间件编写,它自动处理 HTTP 请求与响应的转换。你只需要重写 dispatch 方法,在其中定义请求进入和离开时的逻辑。该基类会自动将 scope、receive 和 send 转换为标准的 Request 和 Response 对象,使代码更易于阅读和维护。

Starlette如何实现中间件Middleware

from starlette.applications import Starlette
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.requests import Request
from starlette.responses import Response, PlainTextResponse

class CustomHeaderMiddleware(BaseHTTPMiddleware):
    async def dispatch(self, request: Request, call_next):
        # 请求进入时:添加自定义头
        request.state.start_time = time.time()
        response = await call_next(request)
        # 响应离开时:添加处理时间头
        process_time = time.time() - request.state.start_time
        response.headers["X-Process-Time"] = str(process_time)
        return response

app = Starlette()
app.add_middleware(CustomHeaderMiddleware)

上述代码展示了如何创建一个记录处理时间的中间件。当请求到达时,我们记录当前时间并存储到 request.state 中。接着调用 call_next 将请求传递给下一个中间件或路由。最后,计算耗时并将其添加到响应头中返回。这种方式避免了手动处理低级别的 ASGI 协议细节。

Starlette 1.5.1
Starlette 1.5.1

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

下载

如何实现符合 ASGI 标准的全功能中间件

如果需要更细粒度的控制或处理非 HTTP 协议(如 WebSocket),可以直接实现 ASGI 接口。这种中间件接收 scope、receive 和 send 三个参数,并返回一个可调用对象。它允许你在任何阶段修改数据流,但需要手动处理异常和生命周期管理。

Starlette如何实现中间件Middleware

import asyncio
from starlette.types import Scope, Receive, Send

class SimpleASGIMiddleware:
    def __init__(self, app):
        self.app = app

    async def __call__(self, scope: Scope, receive: Receive, send: Send):
        if scope['type'] != 'http':
            await self.app(scope, receive, send)
            return

        # 预处理:例如验证 API Key
        headers = dict(scope.get('headers', []))
        api_key = headers.get(b'x-api-key')
        if not api_key:
            await send({
                'type': 'http.response.start',
                'status': 401,
                'headers': [[b'content-type', b'text/plain']],
            })
            await send({
                'type': 'http.response.body',
                'body': b'Unauthorized',
            })
            return

        # 传递给下一个应用
        await self.app(scope, receive, send)

app = Starlette()
app.add_middleware(SimpleASGIMiddleware)

这个示例展示了一个直接操作 ASGI 协议的中间件。它检查请求头中的 X-API-Key,如果缺失则直接发送 401 响应并终止流程。否则,它将控制权交给内部应用。这种写法虽然繁琐,但提供了最大的灵活性,适用于需要深度集成或处理复杂生命周期的场景。

中间件在处理 WebSocket 连接时如何处理关闭信号

在 WebSocket 场景中,中间件需要监听 websocket.disconnect 事件以清理资源。如果使用 BaseHTTPMiddleware,它仅适用于 HTTP 请求,无法处理 WebSocket。因此,对于 WebSocket 中间件,必须实现完整的 ASGI 接口,并在 __call__ 方法中捕获断开连接的事件,以便执行日志记录或资源释放操作。

热门AI工具

更多
码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

咔片AIPPT

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

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

豆包大模型

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

DeepSeek

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

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

SoundView
SoundView Hot

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

WorkBuddy

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

函子Zion

一款支持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 交互文

796

2026.05.09

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

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

679

2026.06.16

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

热门下载

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

精品课程

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

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