Django自定义认证后端致非超级管理员无法访问/admin/页面问题

我之前刚好碰到过一模一样的坑，来分享下解决过程：

问题场景 #

我用Django自带的User、Group、UserManager组件，但是自定义了认证后端MyAuthentication，只实现了判断单个权限的has_perm方法：

class MyAuthentication:
    # ... 其他逻辑代码 ...
    def has_perm(self, user_obj, perm, obj=None):
        permissions = Permission.objects.filter(user=user_obj)
        if perm in permissions:
            return True
        return False

我的用户是普通管理员（非超级用户），所属用户组已经拿到了自定义模型的增删改查全部权限，直接访问模型的操作URL也能正常执行，但一进入/admin/后台页面，就弹出那个扎心的错误：You don't have permission to view or edit anything.

排查与解决 #

一开始翻了好多帖子和Django官方文档，都没找到适配这个场景的办法，后来干脆直接调试Django的源码才发现问题——自定义认证后端必须实现has_module_perms方法！

这个方法是Django Admin用来判断用户是否有权限访问整个模型模块（就是后台左侧的模型菜单入口）的关键，我之前只想着处理单个权限的has_perm，完全漏掉了这个模块级权限的判断方法，导致Admin直接判定用户没有任何模块的访问权限，才弹出了那个错误。

只需要在自定义认证后端里补上这个方法就行，给个参考实现：

class MyAuthentication:
    # ... 已有的其他方法 ...
    def has_perm(self, user_obj, perm, obj=None):
        permissions = Permission.objects.filter(user=user_obj)
        if perm in permissions:
            return True
        return False
    
    # 新增模块权限判断方法
    def has_module_perms(self, user_obj, app_label):
        # 这里可以根据你的权限逻辑调整，比如判断用户是否拥有该app下的任意权限
        return Permission.objects.filter(user=user_obj, content_type__app_label=app_label).exists()

说起来这真是个容易忽略的低级错误，希望能帮到踩同样坑的朋友～

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