FastAPI实现默认管理员全局依赖，特定接口开放非管理员访问

核心思路 #

默认通过全局依赖强制管理员权限验证，对需要开放给普通用户的路由，单独设置仅做基础token有效性验证的宽松依赖，从根源上避免误创建未授权的公开路由。

实现步骤 #

• 拆分验证逻辑：将原有的验证拆分为基础token有效性验证和管理员权限校验两个独立函数
• 全局依赖绑定管理员校验：确保所有路由默认仅允许管理员访问
• 开放路由覆盖依赖：对需要普通用户访问的路由，用dependencies参数替换全局依赖，只执行基础token验证

完整代码示例 #

from fastapi import FastAPI, Request, Depends, HTTPException

# 基础token验证：仅检查token有效性，返回用户信息（含权限标识）
def validate_token(request: Request):
    # 实际业务中：验证请求中的token合法性
    # 从数据库/缓存获取用户详情，示例模拟返回用户数据
    user = {
        "id": 1,
        "username": "regular_user",
        "is_admin": False
    }
    if not user:
        raise HTTPException(status_code=401, detail="无效的身份凭证")
    return user

# 管理员权限校验：依赖基础token验证，额外检查用户是否为管理员
def require_admin(user=Depends(validate_token)):
    if not user["is_admin"]:
        raise HTTPException(status_code=403, detail="仅管理员可访问此接口")
    return user

# 全局依赖设置为管理员校验，默认所有路由仅管理员可进入
app = FastAPI(
    title="My App",
    dependencies=[Depends(require_admin)]
)

# 默认管理员专属路由
@app.get("/admins_only")
def admins_only(user=Depends(require_admin)):
    return {'result': 2, "current_user": user["username"]}

# 开放给普通用户的路由：用dependencies参数覆盖全局依赖，仅做基础token验证
@app.get("/non_admin_route", dependencies=[Depends(validate_token)])
def non_admin_route(user=Depends(validate_token)):
    return {'result': 1, "current_user": user["username"]}

关键说明 #

• 拆分验证逻辑后，既避免了代码重复，也让权限规则更清晰易维护
• 通过路由的dependencies参数覆盖全局依赖，既能让普通用户访问目标路由，又不会跳过身份验证环节
• 默认路由均为管理员权限，只有显式配置宽松依赖的路由才对普通用户开放，彻底降低误操作导致的权限泄露风险

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