starlette 获取 url 查询参数最直接的方式是通过 request.query_params,它返回一个类似字典的对象。你可以像访问普通字典一样使用键来获取值,或者遍历所有参数。如果参数不存在,直接访问会抛出异常,因此建议使用 .get() 方法并提供默认值以确保安全。

如何安全地获取单个可选参数
在处理可选参数时,应始终使用 .get() 方法并指定默认值,避免 KeyError。例如,获取名为 page 的参数,若未提供则默认为 1。这种方式能确保代码在参数缺失时依然正常运行,而不会中断请求处理流程。

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
from starlette.requests import Request
async def get_optional_param(request: Request):
# 获取 'name' 参数,如果不存在则默认为 'Guest'
name = request.query_params.get('name', 'Guest')
return JSONResponse({"user": name})
routes = [
Route('/', endpoint=get_optional_param),
]
app = Starlette(routes=routes)
如何获取重复出现的同名参数
当 URL 中包含多个同名参数(如 ?tags=a&tags=b)时,.get() 只会返回最后一个值。若要获取所有值,需使用 .getlist() 方法。它会返回一个列表,包含该键对应的所有值。这对于处理多选框或过滤条件非常有用。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
from starlette.requests import Request
async def get_multiple_params(request: Request):
# 获取 'tags' 参数的所有值,返回一个列表
tags = request.query_params.getlist('tags')
return JSONResponse({"tags": tags})
routes = [
Route('/', endpoint=get_multiple_params),
]
app = Starlette(routes=routes)
基于 query_params 对象类型的具体问题
request.query_params 返回的是 QueryParams 实例,它是 MultiDict 的子类。这意味着它不仅支持标准的字典操作,还支持多值特性。理解这一点有助于正确处理复杂查询字符串,避免因误用单值方法而导致数据丢失。

















