starlette 实现重定向的核心方式是实例化 starlette.responses.redirectresponse 类并返回该对象。开发者只需传入目标 url,框架会自动处理 http 307 状态码及 location 响应头,将客户端请求引导至新地址。

如何配置默认重定向行为与状态码
在 Starlette 中,可以通过修改 RedirectResponse 的 status_code 属性来改变重定向类型,例如使用 301(永久移动)或 302(临时移动),但推荐使用 307 以保持请求方法不变。

from starlette.applications import Starlette
from starlette.responses import RedirectResponse
from starlette.routing import Route
async def homepage(request):
# 默认使用 307 Temporary Redirect
return RedirectResponse(url="/home")
async def permanent_redirect(request):
# 显式指定 301 Moved Permanently
response = RedirectResponse(url="/archive", status_code=301)
return response
routes = [
Route("/", homepage),
Route("/old-page", permanent_redirect),
]
app = Starlette(routes=routes)
上述代码展示了两种常见的重定向场景。第一个路由 / 返回默认的 307 重定向,适用于大多数临时跳转需求。第二个路由 /old-page 则明确指定了 301 状态码,常用于页面永久迁移。在实际开发中,确保 URL 路径正确且可访问是避免循环重定向的关键。
如何处理带查询参数的动态重定向
当重定向目标需要携带动态参数时,可以直接在 url 参数中拼接字符串或使用 URL 对象构建完整的目标地址。Starlette 不会自动解析 URL 中的查询参数,因此开发者需自行构造完整的 URL 字符串。
Starlette 1.5.1 是轻量级 Python ASGI 框架与工具集,提供路由、请求响应、中间件、WebSocket 和后台任务等组件,适合构建异步 Web 服务。本下载为官方 PyPI 通用 wheel 包,可使用 pip 安装,并由包管理器处理依赖;运行应用时还需配置 ASGI 服务器。

from starlette.responses import RedirectResponse
from starlette.datastructures import URL
async def search_redirect(request):
query = request.query_params.get("q", "default")
# 手动构建包含查询参数的 URL
target_url = f"/results?q={query}&page=1"
return RedirectResponse(url=target_url)
# 或者使用 URL 对象进行更安全的构建
async def safe_redirect(request):
base = URL("/dashboard")
new_url = base.include_query_params(user_id="123", action="login")
return RedirectResponse(url=str(new_url))
在第二个示例中,使用了 URL 对象的 include_query_params 方法来安全地添加查询参数,这比简单的字符串拼接更能避免编码问题。无论采用哪种方式,最终传递给 RedirectResponse 的必须是完整的、格式正确的 URL 字符串。这种处理方式确保了重定向目标的准确性和兼容性。
基于中间件拦截特定路径的重定向逻辑
在 Starlette 应用中,常通过自定义中间件来统一处理重定向逻辑,例如强制 HTTPS 或检查用户权限。当满足特定条件时,中间件直接返回 RedirectResponse 以中断后续处理流程。
from starlette.middleware.base import BaseHTTPMiddleware
from starlette.responses import RedirectResponse
class ForceHTTPS(BaseHTTPMiddleware):
async def dispatch(self, request, call_next):
if not request.url.is_secure and not request.url.host.startswith("localhost"):
# 非本地环境且非 HTTPS,强制重定向到 https
url = request.url.replace(scheme="https")
return RedirectResponse(url=url, status_code=301)
response = await call_next(request)
return response
该中间件检查请求的 URL 是否安全。如果不安全且不在本地开发环境,它会生成一个新的 HTTPS URL 并立即返回重定向响应。这种方式避免了将请求传递到下游应用,提高了安全性和效率。注意,在测试环境中通常忽略 localhost 以避免不必要的重定向循环。










