如何在FastAPI路由级别全局配置Bearer认证避免重复代码

1. 定义通用认证依赖函数 #

先实现可复用的Token验证逻辑，避免在每个路由重复编写认证代码：

from fastapi import Depends, HTTPException, status
from fastapi.security import HTTPBearer, HTTPAuthorizationCredentials

# 初始化Bearer认证方案
security = HTTPBearer()

def validate_bearer_token(credentials: HTTPAuthorizationCredentials = Depends(security)):
    # 替换为你的实际Token验证逻辑（比如校验签名、有效期、关联用户等）
    if credentials.scheme != "Bearer" or not credentials.credentials:
        raise HTTPException(
            status_code=status.HTTP_401_UNAUTHORIZED,
            detail="无效的Bearer Token",
            headers={"WWW-Authenticate": "Bearer"},
        )
    # 验证通过后可返回用户信息或凭证，供后续路由逻辑使用
    return credentials

2. 全局配置认证依赖 #

方式一：给整个API应用全局生效

所有接口自动应用认证，同时/docs页面会自动弹出Bearer Token输入框：

from fastapi import FastAPI

app = FastAPI(
    # 关键：用Depends包裹认证函数，而非直接调用函数
    dependencies=[Depends(validate_bearer_token)]
)

@app.get("/demo")
async def demo_route():
    return {"msg": "已通过全局认证"}

方式二：给指定路由组（APIRouter）全局生效

仅该路由组下的接口应用认证，适合多模块拆分的项目：

from fastapi import APIRouter

api_router = APIRouter(
    dependencies=[Depends(validate_bearer_token)]
)

@api_router.get("/group-demo")
async def group_demo_route():
    return {"msg": "路由组已通过认证"}

# 将路由组注册到主应用
app.include_router(api_router)

3. 解决PyCharm类型警告 #

你遇到的类型不匹配问题，是因为错误地直接传入了认证函数的执行结果（比如[security()]或[validate_bearer_token()]），而dependencies参数要求的是Sequence[Depends]类型——即每个元素是Depends对象（用来定义依赖规则），而非依赖执行后得到的HTTPAuthorizationCredentials实例。

按照上面的代码，用Depends(validate_bearer_token)作为dependencies的元素，就能完全解决类型警告问题。

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