starlette的路由系统通过`router`类管理url到处理函数的映射,核心做法是实例化`router`并传入路由列表,每个路由包含路径字符串和对应的异步可调用对象。开发者只需定义好视图函数,将其与正则表达式兼容的路径绑定,即可构建完整的请求分发逻辑。若路径中包含参数,starlette会自动解析并注入到请求上下文或视图签名中,无需手动提取。

Router如何匹配不同HTTP方法的路由?
Starlette的Router支持按HTTP方法区分路由,通过在创建路由时指定methods参数来实现。例如,将同一个路径分别绑定GET和POST方法,框架会根据请求的方法类型分发到不同的处理函数。这种机制允许在单一URL下处理多种业务逻辑,且互不干扰。开发者需确保每个方法的处理器都符合ASGI接口规范,即接收scope、receive和send三个参数。

from starlette.routing import Router, Route
from starlette.responses import PlainTextResponse
async def get_handler(request):
return PlainTextResponse("GET method")
async def post_handler(request):
return PlainTextResponse("POST method")
# 定义路由列表,指定不同方法
routes = [
Route("/example", handler=get_handler, methods=["GET"]),
Route("/example", handler=post_handler, methods=["POST"]),
]
app = Router(routes=routes)
预期结果:发送GET请求至/example返回“GET method”,发送POST请求返回“POST method”。若使用PUT等未定义方法,将触发405错误。路径参数如/user/{id}同样受方法限制,需在对应方法路由中声明。
如何处理路径中的动态参数?
Starlette使用花括号语法{param_name}定义路径参数,并在视图函数中直接作为关键字参数接收。框架自动验证参数类型,若类型不匹配则返回404。例如,路径/items/{item_id:int}要求item_id为整数,非整数输入将被拒绝。开发者无需手动转换类型,Starlette内置了类型检查器。对于复杂路径,可使用正则表达式,但推荐优先使用标准占位符以保持代码可读性。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.routing import Router, Route
from starlette.responses import PlainTextResponse
async def get_item(request):
item_id = request.path_params["item_id"]
return PlainTextResponse(f"Item ID: {item_id}")
# 定义带类型约束的路由
routes = [
Route("/items/{item_id:int}", handler=get_item),
]
app = Router(routes=routes)
预期结果:访问/items/123返回“Item ID: 123”,访问/items/abc返回404。路径参数也可不加类型约束,此时默认为字符串。多个参数如/users/{user_id}/posts/{post_id}按顺序注入,顺序必须与路径定义一致。
当路由路径存在前缀冲突时,Starlette如何决定最终响应?
当多个路由路径存在子集关系(如/api和/api/users)时,Starlette依据路由注册顺序进行匹配,优先返回最先注册的路由。若/api先注册,则所有以/api开头的请求均被其捕获,除非显式定义更具体的子路径。为避免歧义,建议将具体路径注册在前,通用路径注册在后。此外,可通过add_route方法动态添加路由,后添加的路由优先级高于先添加的同级路径,但不影响已存在的子路径匹配逻辑。
from starlette.routing import Router, Route
from starlette.responses import PlainTextResponse
async def api_root(request):
return PlainTextResponse("API Root")
async def api_users(request):
return PlainTextResponse("Users List")
# 先注册具体路径,再注册通用路径
routes = [
Route("/api/users", handler=api_users),
Route("/api", handler=api_root),
]
app = Router(routes=routes)
预期结果:访问/api/users返回“Users List”,访问/api返回“API Root”。若交换注册顺序,/api/users可能被/api捕获导致404,除非/api路由内部进一步分发。实际行为取决于路由树的遍历顺序,Starlette采用深度优先匹配,具体路径优先于通配路径。










