starlette 获取当前请求 url 的核心方法是访问 request 对象的 url 属性,该属性返回一个包含完整路径、查询参数和主机信息的 url 对象。开发者只需在路由处理函数中接收 request 参数并调用 request.url 即可直接拿到结果。

如何从 Request 对象中提取完整的 URL 字符串
通过访问 request.url 可以直接获得一个 starlette.datastructures.URL 实例,这个对象不仅包含了原始字符串,还提供了结构化访问各个部分的能力。在实际开发中,如果需要将其还原为标准的 URL 字符串,通常使用其 __str__ 方法或隐式转换。例如,当请求是 http://example.com/api/v1/users?id=123 时,调用 str(request.url) 会返回完全相同的字符串。这种处理方式适用于需要记录日志或构建重定向链接的场景。

from starlette.applications import Starlette
from starlette.responses import PlainTextResponse
from starlette.routing import Route
async def get_url(request):
# 获取 URL 对象
url_obj = request.url
# 转换为字符串
full_url_str = str(url_obj)
return PlainTextResponse(full_url_str)
routes = [
Route("/api/test", get_url),
]
app = Starlette(routes=routes)
运行上述代码并访问 /api/test?foo=bar,预期输出结果为:http://localhost:8000/api/test?foo=bar
如何分别获取 URL 的路径、域名和查询参数
除了获取完整字符串,开发者往往需要解析 URL 的特定组成部分。Starlette 的 URL 对象提供了 path、hostname、port、scheme 和 query_params 等属性。其中 query_params 返回的是一个类似字典的对象,支持键值对访问。例如,对于 URL https://myapp.com/search?q=python&page=1,可以通过 request.url.path 获取 /search,通过 request.url.query_params["q"] 获取 python。这种方式比手动解析字符串更安全且符合 Pythonic 风格。
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
import json
async def parse_url_parts(request):
url = request.url
data = {
"full": str(url),
"path": url.path,
"host": f"{url.hostname}:{url.port}",
"scheme": url.scheme,
"query": dict(url.query_params)
}
return JSONResponse(data)
routes = [
Route("/parse", parse_url_parts),
]
app = Starlette(routes=routes)
运行上述代码并访问 /parse?name=test&age=25,预期输出结果为:{"full":"http://localhost:8000/parse?name=test&age=25","path":"/parse","host":"localhost:8000","scheme":"http","query":{"name":"test","age":"25"}}
在反向代理环境下如何正确获取 HTTPS 协议头
当应用部署在 Nginx 或 Apache 等反向代理之后时,外部请求通常是 HTTPS,但代理与后端服务之间可能是 HTTP。此时 request.url 默认可能只反映内部连接信息。为了获取正确的协议和主机名,需要确保代理设置了 X-Forwarded-Proto 和 X-Forwarded-Host 头部。Starlette 的 Request 对象会自动读取这些头部来修正 url 属性的返回值。如果未设置这些头部,可以通过配置 AppMiddleware 或使用 HTTPSRedirectMiddleware 来处理,但在获取阶段,依赖标准头部是最通用的做法。










