You need to enable JavaScript to run this app. Django DRF基于表单按钮实现差异化权限及自定义权限失效问题
优惠活动
大模型
产品
解决方案
定价
更多

Django DRF基于表单按钮实现差异化权限及自定义权限失效问题

DRF ViewSet 角色权限匹配落地实现方案

核心业务规则对齐

  • 员工身份用户:仅允许GET/HEAD/OPTIONS类只读请求访问
  • 经理身份用户:额外开放POST/PUT/PATCH类写操作请求权限

实现步骤

1. 编写视图级自定义权限类

权限判断逻辑直接在has_permission方法中实现,无需下探到对象级校验,代码示例:

from rest_framework.permissions import BasePermission

class RoleBasedViewPermission(BasePermission):
    # 权限不满足时的返回提示信息
    message = "当前用户身份无对应操作权限"

    def has_permission(self, request, view):
        # 拦截未登录请求
        if not request.user.is_authenticated:
            return False
        
        # 构建方法-角色映射关系
        method_role_map = {}
        # 只读方法:两类角色均有权限
        for method in ["GET", "HEAD", "OPTIONS"]:
            method_role_map[method] = {"employee", "manager"}
        # 写操作方法:仅经理角色有权限
        for method in ["POST", "PUT", "PATCH"]:
            method_role_map[method] = {"manager"}
        
        # 获取当前登录用户的角色值
        current_user_role = request.user.profile.role
        allowed_roles = method_role_map.get(request.method, set())
        return current_user_role in allowed_roles

2. 在对应ViewSet上挂载权限配置

直接将自定义权限类绑定到目标视图集,不要做全局配置影响其他接口:

from rest_framework import viewsets
from .models import TargetBusinessModel
from .serializers import TargetBusinessSerializer
from .permissions import RoleBasedViewPermission

class TargetBusinessViewSet(viewsets.ModelViewSet):
    queryset = TargetBusinessModel.objects.all()
    serializer_class = TargetBusinessSerializer
    # 挂载自定义权限类,需搭配项目已配置的认证类使用
    permission_classes = [RoleBasedViewPermission]

常见失效卡点修正

  • 不要将自定义权限类写入全局DEFAULT_PERMISSION_CLASSES配置,否则会覆盖项目内所有接口的默认权限规则
  • 确认认证链路正常,保证request.user能拿到真实登录用户实例,避免权限判断时拿到AnonymousUser
  • 方法名匹配需严格使用全大写字符串,DRF传递的request.method为全大写格式,小写写法会导致映射匹配失败,出现所有请求均被拦截的问题
  • 不要将角色判断逻辑放在has_object_permission方法中,列表查询类的请求不会触发对象级权限校验,会导致只读权限规则完全失效
  • 若ViewSet内自定义了独立action,需通过@action装饰器单独为该接口指定权限规则,避免继承默认权限导致规则错位

内容的提问来源于stack exchange,提问作者Manish Pal

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 15:15:03