fastapi 如何实现基于角色的权限控制(不依赖外部库)
技术百科
冷漠man
发布时间:2026-01-20
浏览: 次 FastAPI可通过依赖注入和自定义依赖项实现轻量RBAC:1.用Pydantic定义角色与权限模型;2.通过get_current_role依赖注入角色;3.用require_permission校验权限;4.可选扩展角色继承与动态权限。
FastAPI 本身不内置 RBAC(基于角色的权限控制),但可以完全不用第三方库(如 fastapi-users、authlib 等),仅靠其依赖注入、依赖项(Depends)、Pydantic 模型和中间件机制,实现轻量、清晰、可扩展的角色权限控制。
1. 定义用户、角色与权限模型
先用 Pydantic 和 Python 原生数据结构描述核心概念,避免过早耦合数据库:
-
角色(Role):如
"admin"、"editor"、"viewer" -
权限(Permission):字符串标识,如
"user:read"、"post:write"、"config:delete" - 角色-权限映射:用字典静态定义或从配置/DB 加载,例如:
ROLE_PERMISSIONS = {
"admin": ["*"], # 通配符表示全部权限(需后端校验时特殊处理)
"editor": ["post:read", "post:write", "user:read"],
"viewer": ["post:read", "user:read"]
}注意:"*" 是语义约定,不是通配符匹配逻辑,后续校验需显式判断。
2. 用户身份认证与角色注入
假设你已通过 JWT 或 Session 完成基础认证,并从中提取出当前用户 ID 和角色(例如从 token payload 或数据库查得)。关键是在每个需要鉴权的路由中,把 role 作为依赖项注入:
- 写一个依赖函数,负责解析凭证 → 获取用户 → 提取角色 → 返回角色名(str)或完整用户对象
- 该函数抛出
HTTPException(status_code=401)或403,FastAPI 会自动终止请求
from fastapi import Depends, HTTPException, status from typing import Annotatedasync def get_current_role() -> str:
示例:从 Authorization header 解析 Bearer Token 并验证(省略 JWT 验证细节)
# 实际中应调用你的 auth 工具函数,返回 role 字符串,如 "editor" token = "fake-token" # ← 替换为真实逻辑 # ... 解码、校验、查 DB 得到 role role = "editor" if not role: raise HTTPException(status_code=status.HTTP_401_UNAUTHORIZED, detail="Invalid or missing credentials") return role
这样,所有需要鉴权的接口都能通过 role: str = Depends(get_current_role) 获得当前角色。
3. 权限检查依赖项(核心)
封装一个可复用的依赖项,接收所需权限字符串,自动比对当前角色是否具备:
from fastapi import Depends, HTTPException, statusdef require_permission(required_perm: str): async def _check(role: str = Depends(get_current_role)) -> None: perms = ROLE_PERMISSIONS.get(role, []) if "*" in perms or required_perm in perms: return raise HTTPException( status_code=status.HTTP_403_FORBIDDEN, detail=f"Role '{role}' lacks permission '{required_perm}'" ) return _check
使用方式非常简洁:
@app.get("/api/posts")
async def list_posts(_=Depends(require_permission("post:read"))):
return [{"id": 1, "title": "Hello"}]支持多权限校验(如同时要读+写)可稍作增强,例如传入列表并全量检查;也可扩展为支持 "post:*" 模式匹配(需自行实现前缀匹配逻辑)。
4. 角色继承与动态权限(进阶可选)
若需角色继承(如 editor 自动拥有 viewer 权限),可改用有向图或层级字典:
ROLE_HIERARCHY = {
"admin": [],
"editor": ["viewer"],
"viewer": []
}
def get_all_permissions_for_role(role: str) -> set:
perms = set(ROLE_PERMISSIONS.get(role, []))
for parent

in ROLE_HIERARCHY.get(role, []):
perms.update(get_all_permissions_for_role(parent))
return perms然后在 require_permission 中调用它替代直查 ROLE_PERMISSIONS。无需 ORM 或外部库,纯逻辑即可支撑常见业务需求。
# ai
# 后端
# python
# app
# 工具
# 路由
# red
# 封装
# session
# 中间件
# fastapi
相关栏目:
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
AI推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
SEO优化<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
技术百科<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
谷歌推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
百度推广<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
网络营销<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
案例网站<?muma echo $count; ?>
】
<?muma
$count = M('archives')->where(['typeid'=>$field['id']])->count();
?>
【
精选文章<?muma echo $count; ?>
】
相关推荐
- Python对象比较与排序_魔术方法解析【教程】
- Win11怎么设置快速访问_Windows11文件
- php怎么下载安装后无法解析php文件_服务器配置
- Linux如何使用Curl发送请求_Linux下A
- Win11怎么设置开机问候语_自定义Win11锁屏
- Win11摄像头无法使用怎么办_Win11相机隐私
- Win11如何设置文件权限 Win11 NTFS文
- php8.4如何调用com组件_php8.4win
- Python爬虫项目实战教程_Scrapy抓取与存
- 如何用正则与预处理结合精准拦截拼接式垃圾域名
- c++怎么实现大文件的分块读写_c++ 文件指针s
- 手机php怎么转mp4_手机端php文件转mp4a
- Python模块的__name__属性如何由导入方
- Windows电脑键盘突然失灵怎么办?(驱动与硬件
- VSC怎样在Linux运行PHP_Ubuntu系统
- php8.4xdebug无法调试怎么办_php8.
- Python抽象类与接口设计_规范说明【指导】
- Windows10怎样设置家长控制_Windows
- Windows服务启动类型恢复方法_错误修改导致的
- 微信企业付款回调PHP怎么接收_处理企业付款异步通
- Mac怎么设置登录项_Mac管理开机自启动程序【教
- Python代码测试策略_质量保障解析【教程】
- 如何使用Golang reflect检查方法数量_
- PythonFastAPI项目实战教程_API接口
- Mac如何调整Dock栏大小和位置_Mac程序坞个
- Win11怎么更改计算机名_Windows11系统
- Win11怎么更改系统语言为中文_Windows1
- Win11怎么关闭右下角弹窗_Win11拦截系统通
- 如何在Windows中创建新的用户账户?(标准与管
- C++中的协变与逆变是什么?C++函数指针与返回类
- 静态属性修改会影响所有实例吗_php作用域操作符下
- Win10电脑怎么设置网络名称_Windows10
- 如何使用Golang sync.Map实现并发安全
- 如何使用Golang实现RPC序列化与反序列化_G
- 手机php文件怎么变成mp4_安卓苹果打开php转
- Win11无法安装软件怎么办_Win11解除应用安
- Windows10电脑怎么设置文件权限_Win10
- Windows10任务栏图标变成白色文件_Win1
- c++20的std::format怎么用 比pri
- Win11怎么查看显卡温度 Win11任务管理器查
- c++ stringstream用法详解_c++字
- VSC怎么配置PHP的Xdebug_远程调试设置步
- Mac如何整理桌面文件_Mac使用堆栈功能一键整理
- php串口通信波特率怎么选_根据硬件手册设置正确波
- Win11怎么更改管理员名字 Win11修改账户名
- c++怎么实现高并发下的无锁队列_c++ std:
- 如何使用 Python 合并文件夹内多个 Exce
- Win10怎么卸载鲁大师_Win10彻底卸载鲁大师
- php高频调试功能有哪些_php常用调试函数与工具
- Windows怎样关闭开始菜单广告_Windows


QQ客服