Django如何基于请求与模型实现权限自动校验?
你提到的自动匹配默认增删改查权限、在数据库操作前完成校验、适配大量用户组差异化权限的需求,Django本身的内置机制就可以全覆盖,不需要为每个接口单独写校验逻辑。
通用落地实现方案
1. 视图层全自动权限匹配(适配通用类视图场景)
Django自带的PermissionRequiredMixin已经提供了基础的权限校验能力,只需要写一个全局通用的基类视图,就能让所有继承的业务视图自动匹配对应模型的默认权限,完全不用手动为每个视图配置权限串。
- 固定的权限映射规则:
- 创建类视图(
CreateView)自动关联[app_label].add_[model_name]权限 - 更新类视图(
UpdateView)自动关联[app_label].change_[model_name]权限 - 查询类视图(
ListView/DetailView)自动关联[app_label].view_[model_name]权限 - 删除类视图(
DeleteView)自动关联[app_label].delete_[model_name]权限
- 创建类视图(
- 参考实现代码:
from django.views.generic import CreateView, UpdateView, DetailView, ListView, DeleteView from django.contrib.auth.mixins import PermissionRequiredMixin from .models import Article # 全局通用权限校验基类,所有业务视图继承即可 class ModelPermCheckMixin(PermissionRequiredMixin): def get_permission_required(self): # 自动读取当前视图关联的模型,生成对应权限串 model = self.model app_label = model._meta.app_label model_name = model._meta.model_name op_map = { CreateView: f"{app_label}.add_{model_name}", UpdateView: f"{app_label}.change_{model_name}", DetailView: f"{app_label}.view_{model_name}", ListView: f"{app_label}.view_{model_name}", DeleteView: f"{app_label}.delete_{model_name}", } for view_cls, perm in op_map.items(): if isinstance(self, view_cls): return (perm,) return super().get_permission_required() # 业务视图只需要指定关联模型即可,完全不用写权限校验逻辑 class ArticleCreateView(ModelPermCheckMixin, CreateView): model = Article fields = ["title", "content"]
这种方案下,readers组用户访问新增Article的视图时,基类会自动校验article.add_article权限,无权限会直接返回403,不会进入视图业务逻辑。
2. 全局请求级拦截(适配自定义函数视图、散落在页面的表单提交场景)
针对你提到的“首页表单提交新增Article”这类不属于通用类视图的场景,可以写一个轻量的全局中间件,自动根据请求方法、路由关联的模型匹配对应权限,不需要为每个函数视图单独加权限装饰器。
- 匹配规则:
- POST请求(新增提交)对应模型的add权限
- PUT/PATCH请求(修改提交)对应模型的change权限
- DELETE请求对应模型的delete权限
- GET请求(页面访问、数据拉取)对应模型的view权限
- 参考实现代码(简化版):
from django.http import HttpResponseForbidden class AutoPermCheckMiddleware: def __init__(self, get_response): self.get_response = get_response def __call__(self, request): # 跳过登录、静态资源、后台管理这类不需要自定义权限校验的路径 if request.path.startswith(("/admin/", "/login/", "/static/")): return self.get_response(request) # 从路由配置中读取当前请求关联的模型(路由配置时给对应视图标记关联模型即可) related_model = getattr(request.resolver_match.func, "model", None) if not related_model: return self.get_response(request) app_label = related_model._meta.app_label model_name = related_model._meta.model_name op_perm_map = { "POST": f"{app_label}.add_{model_name}", "PUT": f"{app_label}.change_{model_name}", "PATCH": f"{app_label}.change_{model_name}", "DELETE": f"{app_label}.delete_{model_name}", "GET": f"{app_label}.view_{model_name}", } required_perm = op_perm_map.get(request.method) if required_perm and not request.user.has_perm(required_perm): # 无权限直接返回403,不会进入视图逻辑,更不会执行数据库查询 return HttpResponseForbidden("无对应操作权限") return self.get_response(request)
按照这个逻辑,首页的新增Article表单提交POST请求时,中间件会自动校验用户的article.add_article权限,readers组仅拥有view权限的话,提交请求会被直接拦截,根本不会执行Article的新增数据库操作,完全符合你提到的场景需求。
3. 模型层兜底校验(在数据库操作执行前完成权限校验)
如果担心上层逻辑出现漏洞被绕过,可以重写模型的Manager和QuerySet,在所有数据库操作执行前插入权限校验逻辑,实现你提到的“在模型层编写通用校验、查询前检查权限”的目标。
- 参考实现代码:
from django.db import models from django.core.exceptions import PermissionDenied # 通过项目内通用的请求上下文获取当前登录用户(常用threadlocal实现,无需手动传递) from .utils import get_current_request_user class AuthCheckedManager(models.Manager): def get_queryset(self): current_user = get_current_request_user() qs = super().get_queryset() # 未登录、后台命令、定时任务场景跳过校验 if not current_user or not current_user.is_authenticated: return qs # 拉取数据前校验view权限,无权限直接返回空QuerySet view_perm = f"{self.model._meta.app_label}.view_{self.model._meta.model_name}" if not current_user.has_perm(view_perm): return qs.none() return qs def create(self, **kwargs): # 创建数据前校验add权限,无权限直接抛异常 current_user = get_current_request_user() if current_user and current_user.is_authenticated: add_perm = f"{self.model._meta.app_label}.add_{self.model._meta.model_name}" if not current_user.has_perm(add_perm): raise PermissionDenied("无新增数据权限") return super().create(**kwargs) # Article模型使用带权限校验的管理器即可 class Article(models.Model): title = models.CharField(max_length=100) content = models.TextField() objects = AuthCheckedManager()
这种方式下,哪怕上层视图、中间件的校验被绕过,只要代码执行到数据库操作的环节,模型层的逻辑就会自动完成权限校验,在真正执行SQL之前就拦截无权限的请求。
适配多用户组场景的说明
这套机制完全不需要随着用户组的数量增长调整代码:所有校验逻辑都是直接读取Django内置的权限表、用户-组-权限的关联映射关系,你在后台给不同用户组配置什么权限,校验逻辑就会自动识别,不需要为每个组单独写判断逻辑。
建议三层校验搭配使用:全局中间件做第一道拦截,视图基类做第二道校验,模型管理器做最后兜底,全程没有重复的校验代码,就能覆盖绝大多数权限控制场景。
内容的提问来源于stack exchange,提问作者Ravexina

