FastAPI 重定向功能详解：如何优雅地实现 URL 跳转
在进入 FastAPI 的重定向功能之前，了解一些基础知识有助于我们更好地掌握这个框架。FastAPI 是一个现代、快速（高性能）的 web 框架，用于构建 API，它基于 Python 的类型提示。其简单易用的特性使得开发者可以迅速搭建起可靠的应用程序。此外，FastAPI 支持自动生成文档，这为我们在后续的开发中带来了方便。
重定向是 web 开发中常见的一个概念。当用户尝试访问某个 URL 时，可能出于很多原因需要引导他们到另一个 URL。这种机制通常用于网站的布局更新、URL 的变化，甚至是服务端在处理请求时的行为调整。对于使用 FastAPI 的开发者而言，掌握重定向的基本概念非常重要。
那么，何时需要使用重定向呢？在一些场景中，例如需要改变用户的访问路径时，或者当用户应被指引到最新的内容时，重定向都显得尤为重要。它可以帮助我们维护良好的用户体验，确保用户能够顺利找到需要的资源。在 FastAPI 中，实现重定向的方式多种多样，非常灵活。在这个框架里，我们会发现处理重定向变得简单而有效，接下来，我们会一起探索 FastAPI 中如何优雅地实现重定向。
在本章节，我们将亲自体验 FastAPI 中的重定向实现。这对于需要在网络应用中引导用户到不同页面的场景尤其重要。无论是简单的页面跳转，还是更复杂的状态保持与处理，FastAPI 都能提供优雅的解决方案。
基于 GET 请求的重定向示例
首先，我们来看一个简单的基于 GET 请求的重定向示例。这是最常见的使用场合，如果我们希望用户从旧的 URL 跳转到新的 URL，可以使用 FastAPI 中的 RedirectResponse。例如，假设我们有一个旧的页面 URL，我们可以很容易地实现以下代码：
from fastapi import FastAPI
from fastapi.responses import RedirectResponse
app = FastAPI()
@app.get("/old-url")
def redirect_to_new_url():
return RedirectResponse(url="/new-url")
这个简单的路由会把所有访问 /old-url 的用户重定向到 /new-url，这为我们便捷地管理 URL 和页面变动提供了便利。
在某些情况下，我们需要使用路径参数来实现更灵活的重定向。例如，一个类似于动态用户个人页面的 URL 可以通过路径参数传递。假设我们想要重定向到每个用户自己的页面，可以这样写：
@app.get("/user/{user_id}/old")
def redirect_user_to_new(user_id: int):
return RedirectResponse(url=f"/user/{user_id}/new")
这里，当用户访问特定的旧用户页面时，将会自动重定向到他们的新页面，提供了个性化的体验。
基于 POST 请求的重定向实现
我们再来看基于 POST 请求的重定向。在典型的 web 应用中，用户提交表单后，可能需要跳转到一个确认页面或结果页面。使用 FastAPI，我们可以轻松实现从 POST 请求重定向至 GET 请求的功能。
首先进行一个 POST 请求的处理，当表单数据成功提交后，我们可以引导用户到确认页面：
from fastapi import FastAPI, Form, Request
from fastapi.responses import RedirectResponse
app = FastAPI()
@app.post("/submit/")
async def submit_form(name: str = Form(...)):
return RedirectResponse(url="/thank-you", status_code=303)
在这个例子中，用户提交的表单数据会被处理，我们使用 303 状态码对应的重定向引导用户访问 /thank-you 页面。
另一个重要的方面是如何在重定向时保持状态。最佳实践是利用 session 或 token 来保存用户的数据，然后在后续请求中使用这些数据。例如，我们可以结合自定义的 session 管理，实现将用户的状态在重定向中保留，确保用户体验良好。
我们已经探讨了如何处理 GET 请求和 POST 请求的重定向。接下来，错误处理与重定向也是一个值得关注的领域。