starlette 通过 request 对象的 headers 属性读取请求头,该属性返回一个 multidict 类型的对象。开发者可以直接使用方括号语法如 request["header-name"] 获取指定头部值,或使用 request.headers.get("header-name") 方法获取并处理缺失情况。由于 http 头部不区分大小写且支持重复键,这种设计确保了获取数据的准确性和灵活性。

如何获取单个请求头的具体值
要获取单个请求头的值,最直接的方法是使用下标访问 request["key"]。如果请求中不存在该头部,Starlette 会抛出 KeyError 异常。为了避免程序崩溃,通常建议结合 try-except 块或改用 .get() 方法。例如,获取 Content-Type 时,若未设置则返回 None 或默认值。这种方式适用于明确知道头部存在且只需单一值的场景。

from starlette.requests import Request
from starlette.responses import JSONResponse
async def get_header_value(request: Request):
# 直接访问,若不存在则报错
try:
content_type = request["content-type"]
except KeyError:
content_type = "application/octet-stream"
return JSONResponse({"content_type": content_type})
如何处理多个相同名称的请求头
当请求中包含多个同名头部(如 Set-Cookie)时,下标访问仅返回最后一个值。若需获取所有同名头部的列表,应使用 request.getlist("key") 方法。该方法返回一个包含所有匹配值的列表,确保不会遗漏任何数据。这对于解析 Cookie 或其他多值头部至关重要,避免了因只取最后一个值而导致的数据丢失。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.requests import Request
from starlette.responses import JSONResponse
async def get_all_cookies(request: Request):
# 获取所有 Set-Cookie 头部的值
cookies = request.getlist("set-cookie")
return JSONResponse({"cookies": cookies})
基于请求头中是否存在 Authorization 字段的具体问题
在鉴权场景中,常需检查请求是否携带 Authorization 头。可通过 "authorization" in request.headers 判断其存在性,或使用 request.headers.get("authorization") 获取值并验证。若值为空或缺失,可拒绝请求或返回未授权状态。此方法简单有效,无需额外依赖即可实现基础的身份验证逻辑。










