starlette 通过路径字符串中的花括号语法(如 {param_name})定义路由参数,并在请求处理函数中将其作为关键字参数自动注入。开发者只需在 route 或 apirouter 的路径模板中声明占位符,即可在视图函数中直接获取转换后的值。若需限制参数类型,可结合 pathconverter 实现更严格的校验。

如何定义带参数的路由并获取值
在 Starlette 中,定义带参路由的核心是在 URL 模式中使用大括号包裹变量名。框架会自动解析请求路径,提取对应片段,并将其转换为字符串传递给视图函数。例如,访问 /users/123 时,若路由定义为 /users/{user_id},则 user_id 将作为字符串 "123" 传入。

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)运行上述代码后,向 /users/42 发送 GET 请求,返回的 JSON 为 {"id": "42"}。注意 path_params 中的值始终为字符串类型,即使路径部分看起来像数字。若需要整数类型,需在视图中手动转换,如 int(user_id)。
如何实现类型转换与校验
Starlette 支持通过自定义转换器或在路由注册时指定类型来简化参数处理。虽然原生 Route 不直接支持类型注解自动转换,但可以通过继承 BaseConverter 实现。例如,创建一个 IntConverter 将路径段解析为整数,并在 Starlette 初始化时注册该转换器。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.convertors import BaseConverter, register_converter
class IntConverter(BaseConverter):
regex = r"\d+"
def convert(self, value):
return int(value)
def to_url(self, value):
return str(value)
register_converter(IntConverter, "int")
# 在路由中使用自定义转换器
routes = [
Route("/items/{item_id:int}", get_item),
]使用 {item_id:int} 语法后,Starlette 会调用 IntConverter 进行转换。若路径段不符合正则表达式 \d+,则返回 404。这种方式避免了在视图函数中重复编写类型转换逻辑,同时提供了路径级别的校验。预期结果:访问 /items/99 成功,访问 /items/abc 失败。
如何处理路径参数缺失或格式错误
当请求路径与路由模板不匹配时,Starlette 默认返回 404 Not Found。例如,若路由定义为 /users/{user_id},而请求为 /users(缺少参数),框架不会调用视图函数,而是直接触发 404 响应。这是因为路由匹配发生在请求分发阶段,参数缺失意味着无匹配路由。
对于格式错误,如使用自定义转换器 IntConverter 时传入非数字字符,同样会因正则不匹配而返回 404。开发者无需在视图中处理这些异常,因为框架已拦截。若需自定义错误响应,可通过挂载异常处理器实现,但这不属于路由参数传递的直接范畴。验证输入:请求 /users/ 返回 404;请求 /items/xyz 返回 404。这确保了参数传递的健壮性,避免无效数据进入业务逻辑。


















