FastAPI 小技巧：一文搞懂多重路由绑定与动静态路由共存

📌 用最少的代码，实现最灵活的 API 路由设计！

在 FastAPI 开发中，你是否遇到过以下需求？

同一个函数要响应多个 URL 路径？
同一个路径 /user/xxx 既要支持动态参数（如 /user/123），又要保留一个固定路径（如 /user/userid）？

今天，我们就通过一段简洁的示例代码，带你掌握 多重路由绑定 和 动静态路由共存 的实用技巧！

🔧 示例代码速览

#!/usr/bin/env python
# -*- coding: utf-8 -*-

from fastapi import FastAPI
from starlette.responses import JSONResponse

app = FastAPI()

# ============ 多重URL地址绑定函数 ============
@app.get('/', response_class=JSONResponse)
@app.get('/index', response_class=JSONResponse)
@app.post('/index', response_class=JSONResponse)
@app.get("/app/hello", tags=['app实例对象注册接口-示例'])
def app_hello():
    return {"Hello": "app api"}

# ============ 同一个URL动态和静态路由 ===========
# 动态路由
@app.get('/user/{userid}')
async def login(userid: str):
    return {"Hello": "dynamic"}

# 静态路由
@app.get('/user/userid')
async def login():
    return {"Hello": "static"}

🎯 技巧一：一个函数，多个入口（多重路由绑定）

FastAPI 允许你为同一个视图函数绑定多个 HTTP 方法和路径，只需重复使用装饰器即可：

@app.get('/')
@app.get('/index')
@app.post('/index')
def app_hello():
    return {"Hello": "app api"}

✅ 效果：

GET / → 返回 {"Hello": "app api"}
GET /index → 同上
POST /index → 同上

💡 应用场景：

兼容旧版 API 路径（如 / 和 /index 同时存在）
同一逻辑支持多种请求方式（如 GET 查看状态，POST 触发操作）

📝 小贴士：response_class=JSONResponse 其实是默认行为，可省略。但显式写出有助于代码可读性。

🔄 技巧二：动静态路由共存（路径优先级揭秘）

你可能担心：/user/{userid} 是动态路由，会不会“吃掉” /user/userid 这个静态路径？

答案是：不会！FastAPI 会优先匹配静态路由！

@app.get('/user/{userid}')      # 动态：匹配 /user/123、/user/abc 等
async def dynamic_login(userid: str):
    return {"Hello": "dynamic"}

@app.get('/user/userid')         # 静态：只匹配 /user/userid
async def static_login():
    return {"Hello": "static"}

✅ 测试结果：

访问 http://127.0.0.1:8000/user/123 → 返回 {"Hello": "dynamic"}
访问 http://127.0.0.1:8000/user/userid → 返回 {"Hello": "static"}

🔍 原理：
FastAPI 在注册路由时，会优先匹配更具体的路径。静态路径 /user/userid 比动态路径 /user/{userid} 更具体，因此优先级更高。

⚠️ 注意：两个函数不能同名！示例中虽然都叫 login，但在实际运行中会报错（Python 函数名冲突）。建议重命名为 user_detail 和 user_placeholder 等不同名称。

🚀 启动服务（附带小彩蛋）

代码末尾的启动逻辑也很巧妙：

if __name__ == "__main__":
    import uvicorn
    import os

    app_model_name = os.path.basename(__file__).replace(".py", "")
    uvicorn.run(f"{app_model_name}:app", host='127.0.0.1', reload=True)

自动获取当前文件名作为模块名（无需硬编码）
开启 reload=True，代码修改自动重启，开发超方便！

✅ 总结

技巧	作用	适用场景
多重路由绑定	一个函数响应多个路径/方法	兼容性、简化逻辑复用
动静态路由共存	静态路径优先于动态路径	保留特殊路径（如文档、占位符）