starlette 获取请求来源 referer 的正确做法是通过 request.url 对象调用其 .path_for() 方法,或者更直接地通过 request.headers.get('referer') 获取原始字符串。推荐使用 request.url.path 结合路由名称生成 url,而获取来源页面地址则应检查 referer 请求头。

如何从 Request 对象中读取 Referer 头部
在 Starlette 中,可以通过 request.headers.get('referer') 直接获取客户端发送的 Referer 字段值。如果该字段不存在,将返回 None。这是最基础且常用的方式,适用于需要知道用户从哪个页面跳转过来的场景。

from starlette.applications import Starlette
from starlette.responses import JSONResponse
from starlette.routing import Route
import uvicorn
async def get_referer(request):
referer = request.headers.get('referer')
return JSONResponse({"referer": referer})
app = Starlette(routes=[Route('/check', get_referer)])
if __name__ == '__main__':
uvicorn.run(app, host='0.0.0.0', port=8000)
如何根据路由名称生成目标 URL 而非依赖 Referer
如果需要生成指向特定页面的链接,不应依赖 Referer,而应使用 request.url.path_for(name)。该方法基于当前请求上下文和路由定义生成绝对或相对 URL,确保链接正确性。这种方式比解析 Referer 更可靠,因为 Referer 可能被篡改或缺失。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.applications import Starlette
from starlette.responses import HTMLResponse
from starlette.routing import Route
import uvicorn
async def home(request):
# 生成指向 /about 页面的 URL
about_url = request.url.path_for('about_page')
return HTMLResponse(f'<a href="%7Babout_url%7D">Go to About</a>')
async def about_page(request):
return HTMLResponse('<h1>About Page</h1>')
app = Starlette(routes=[
Route('/', home, name='home'),
Route('/about', about_page, name='about_page')
])
if __name__ == '__main__':
uvicorn.run(app, host='0.0.0.0', port=8000)
当 Referer 为空时如何处理跨域请求来源判断
当 Referer 为空时,通常意味着请求来自书签、新标签页打开、JavaScript 重定向或隐私设置阻止了来源信息。此时无法准确判断用户来源,应视为“未知来源”。在安全敏感场景中,可结合 Origin 头进行辅助判断,但需注意 Origin 仅用于跨域请求,且同样可能缺失。建议对空 Referer 采取降级策略,如限制功能或要求重新认证。










