Django REST框架自定义权限中raise PermissionDenied自定义消息不生效问题

问题根因 #

该问题90%以上的场景由两个原因导致：

• 错误导入了Django原生的PermissionDenied异常，而非DRF自带的异常类，DRF无法识别原生异常的自定义消息
• DRF默认异常处理器会标准化权限异常返回，覆盖了你抛出的自定义内容

解决方法 #

方案1：修正导入包（优先尝试，最简单） #

确保你的导入语句是DRF的异常类，不要用Django原生的：

# 正确导入
from rest_framework.exceptions import PermissionDenied
# 错误导入，会导致自定义消息失效
# from django.core.exceptions import PermissionDenied

修改导入后重启服务即可生效，抛出的自定义消息会直接返回。

方案2：自定义异常处理器（如果导入修正后仍不生效） #

如果项目有自定义过异常处理逻辑，可新增权限异常的适配：

1. 新建异常处理文件（例如utils/exceptions.py）：

from rest_framework.views import exception_handler
from rest_framework.exceptions import PermissionDenied

def custom_exception_handler(exc, context):
    # 先调用DRF默认的异常处理获取响应对象
    response = exception_handler(exc, context)
    # 适配权限异常的自定义消息
    if isinstance(exc, PermissionDenied) and response is not None:
        response.data['detail'] = exc.detail
    return response

2. 在settings.py中注册该异常处理器：

REST_FRAMEWORK = {
    'EXCEPTION_HANDLER': '你的项目目录.utils.exceptions.custom_exception_handler',
    # 其他原有DRF配置保持不变
}

方案3：符合DRF规范的替代实现（无需抛异常） #

DRF的权限类本身支持自定义错误消息，直接返回False即可自动返回自定义内容，无需主动抛出异常：

class CustomPermission(BasePermission):
    """
    根据请求方法和slug返回权限校验结果
    """
    # 默认权限错误消息
    message = "你没有权限执行此操作"

    def has_permission(self, request,view):
        slug = request.resolver_match.kwargs["slug"]
        if slug is not None and request.method == 'POST':
            if slug == "abc":
                user = request.user
                if user.is_staff:
                    return True
                if user.is_anonymous:
                    print("iam here")
                    # 动态修改当前场景的错误消息
                    self.message = "Anonymous user"
                    return False
            elif slug == "mnp":
                return True
        else:
            return True

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