starlette 通过内置的 asgi 接口处理异步 http 请求,开发者只需定义继承自 request 和 response 的对象并在路由中注册异步视图函数即可实现。核心做法是创建一个 starlette 应用实例,使用装饰器将 url 路径映射到异步处理函数,该函数接收请求对象并返回响应对象,最终由 asgi 服务器(如 uvicorn)接管底层网络 i/o 进行并发调度。

如何配置路由以匹配特定路径参数
在 Starlette 中,可以通过在路由路径字符串中使用尖括号语法来捕获路径参数,例如 /users/{user_id}。当请求到达时,框架会自动解析 URL 并将捕获的值注入到视图函数的参数中,开发者可以直接在函数签名中声明这些参数类型,无需手动从 URL 字符串中拆分。

Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。
from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
async def get_user(request):
user_id = request.path_params['user_id']
return JSONResponse({"id": user_id})
routes = [
Route("/users/{user_id}", get_user),
]
app = Starlette(routes=routes)
如何处理查询字符串中的可选参数
Starlette 提供了 request.query_params 属性,它是一个类似字典的对象,用于存储 URL 查询字符串中的键值对。开发者可以通过直接访问键名或使用 .get() 方法来获取参数,若参数不存在则返回默认值或 None,这种方式使得处理可选过滤条件变得非常直观且安全。

from starlette.responses import PlainTextResponse
async def search_items(request):
q = request.query_params.get('q', '')
limit = int(request.query_params.get('limit', '10'))
return PlainTextResponse(f"Searching for {q} with limit {limit}")
基于 request.state 存储中间件数据的具体问题
在 Starlette 中,request.state 是一个专门用于在请求生命周期内共享数据的对象,通常由中间件填充。如果中间件尝试向 request.state 设置一个已存在的属性,后续代码读取该属性时会得到中间件设置的最新值,这确保了数据流在中间件链和处理函数之间的一致性,避免了全局变量的污染。

















