如何在FastAPI中实现动态路由别名？

你可以通过FastAPI的动态路径参数实现需求，无需预先配置所有路由，新增图片后自动适配。以下是两种常用实现方式：

方式1：内部逻辑转发（无URL跳转） #

直接在动态路由里复用原/photo接口的业务逻辑，用户访问/myimage/xxx时，后台自动拼接成imgxxx的ID并查询数据，浏览器地址栏不会变化。

假设你的/photo/index.py原有代码如下：

from fastapi import APIRouter, Query
# 假设你有一个从数据库获取元数据的工具函数
from your_db_utils import get_photo_metadata

router = APIRouter(prefix="/photo")

@router.get("/")
async def get_photo_metadata_api(id: str = Query(...)):
    metadata = get_photo_metadata(id)
    return metadata

在主应用文件（比如main.py）中添加动态路由：

from fastapi import FastAPI
from photo.index import router as photo_router
from your_db_utils import get_photo_metadata

app = FastAPI()
app.include_router(photo_router)

# 动态路由别名，匹配/myimage/后的任意后缀
@app.get("/myimage/{suffix}")
async def myimage_alias(suffix: str):
    # 拼接成完整的图片ID
    photo_id = f"img{suffix}"
    # 直接调用原查询逻辑
    return get_photo_metadata(photo_id)

如果需要限制后缀格式（比如必须是3位数字），可以用正则约束路径参数：

@app.get("/myimage/{suffix:regex(r'^\d{3}$')}")
async def myimage_alias(suffix: str):
    photo_id = f"img{suffix}"
    return get_photo_metadata(photo_id)

方式2：HTTP重定向（URL跳转） #

如果希望用户访问/myimage/xxx后，浏览器地址栏自动跳转到原/photo/?id=imgxxx接口，可以用RedirectResponse：

from fastapi import FastAPI
from fastapi.responses import RedirectResponse
from photo.index import router as photo_router

app = FastAPI()
app.include_router(photo_router)

@app.get("/myimage/{suffix}")
async def myimage_alias(suffix: str):
    target_url = f"/photo/?id=img{suffix}"
    return RedirectResponse(url=target_url)

说明 #

• 两种方式都支持动态新增图片，只要图片ID遵循img+后缀的格式，无需手动添加新路由。
• 内部转发更适合不需要暴露原接口URL的场景；重定向则更直观，用户能看到实际请求的接口地址。

内容的提问来源于stack exchange，提问作者NDS