Django基于DRF实现自定义权限角色模型的鉴权与前端管理方法
自定义权限/角色模型接入DRF鉴权流程的落地步骤
基础配置调整
- 打开项目
settings.py文件,修改鉴权后端配置:移除默认的django.contrib.auth.backends.ModelBackend,后续所有鉴权逻辑走自定义实现的后端类,避免和Django默认的auth权限表逻辑耦合 - 如果项目使用了自定义用户模型,提前配置
AUTH_USER_MODEL参数指向对应的用户模型路径,避免和角色、权限表的外键关联出现映射错误
自定义鉴权逻辑实现
- 继承Django的
BaseBackend类,实现两个核心校验方法:get_user_permissions:查询用户直接关联的独立权限列表get_all_permissions:聚合用户直接权限、通过角色关联继承的权限集合,形成完整的权限码列表
- 为权限查询逻辑增加缓存机制,同一个用户单次请求内只查询一次权限数据,不要每次校验权限都重复执行连表查询,减少数据库压力
- 基于DRF的
BasePermission类封装自定义权限校验组件,把上述权限校验逻辑接入DRF的请求生命周期,替代内置的DjangoModelPermissions、IsAuthenticated等依赖默认权限表的权限类,可直接在视图集的permission_classes参数中挂载使用
全链路接口流程打通
- 扩展用户登录接口的响应结构:用户完成身份校验、拿到鉴权凭证(JWT Token/会话ID)时,接口同步返回当前用户的角色列表、权限码集合,前端可基于该数据实现菜单渲染、按钮显隐控制
- 所有权限、角色、用户权限关联的增删改操作,完成数据落库后主动清空对应用户的权限缓存,避免旧缓存数据导致权限更新后鉴权逻辑不生效
- 统一在视图层做权限校验收口,不要在单个接口的业务逻辑里零散写权限判断代码,降低后续维护成本
落地注意事项
- 全程不依赖Django Admin的权限同步机制,所有自定义权限的编码、名称规则需要前后端提前对齐(比如统一用
模块:操作的格式作为权限唯一标识,例如user:export) - 配置外键关联的级联规则:删除角色、删除权限时,不要物理删除关联的用户-角色、角色-权限关联数据,避免产生无归属的游离关联记录
- 不要直接修改Django原生权限系统的核心源码,全部通过自定义鉴权后端、自定义权限类的方式做逻辑扩展,避免版本升级时出现兼容问题
- 注意:权限缓存的有效期不要设置过长,避免权限回收后用户还能在缓存有效期内访问越权接口
内容的提问来源于stack exchange,提问作者Devang Hathalia
相关产品推荐
相关产品推荐

