FastAPI 依赖注入的三种姿势

三种姿势

FastAPI 的依赖注入本质上是「在请求进 handler 之前，先跑一段可复用的逻辑」。

1. 函数依赖

最常用，适合取当前用户、校验 token：

from fastapi import Depends

async def get_current_user(token: str = Header(...)):
    return decode(token)

@app.get("/me")
async def me(user=Depends(get_current_user)):
    return user

2. 类依赖

需要配置或状态时，把依赖写成类，__call__ 返回结果：

class Paginator:
    def __init__(self, size: int = 20):
        self.size = size
    def __call__(self, page: int = 1):
        return {"offset": (page - 1) * self.size, "limit": self.size}

@app.get("/items")
async def items(pager = Depends(Paginator(50))):
    return pager

3. 全局依赖

鉴权、限流这类横切逻辑，挂到 app 上一次搞定：

app = FastAPI(dependencies=[Depends(verify_api_key)])

选型速查