Django中权限与组信息不显示问题咨询

1. 未在Admin中注册Group模型 #

Django默认会自动注册Group到后台，但如果手动修改admin.py时误删了相关逻辑，会导致组信息不显示。

• 解决：在项目或对应app的admin.py中添加注册代码：

from django.contrib.auth.models import Group
from django.contrib import admin

admin.site.register(Group)

注：Permission模型无需单独注册，默认会在用户编辑页面关联展示；若需单独在后台列出，可添加admin.site.register(Permission)。

2. 自定义User模型未关联权限系统 #

若使用自定义用户模型但未正确继承权限相关基类，会导致权限、组无法和用户关联显示。

• 解决：
  • 优先让自定义User模型继承AbstractUser，自动获得权限和组关联字段：

    from django.contrib.auth.models import AbstractUser
    
    class CustomUser(AbstractUser):
        # 自定义字段
        pass
    

  • 若必须继承AbstractBaseUser，需手动混入PermissionsMixin并配置管理器：

    from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin, BaseUserManager
    from django.db import models
    
    class CustomUserManager(BaseUserManager):
        def create_user(self, username, password=None, **extra_fields):
            user = self.model(username=username, **extra_fields)
            user.set_password(password)
            user.save(using=self._db)
            return user
    
        def create_superuser(self, username, password, **extra_fields):
            extra_fields.setdefault('is_staff', True)
            extra_fields.setdefault('is_superuser', True)
            return self.create_user(username, password, **extra_fields)
    
    class CustomUser(AbstractBaseUser, PermissionsMixin):
        username = models.CharField(max_length=150, unique=True)
        is_active = models.BooleanField(default=True)
        is_staff = models.BooleanField(default=False)
        
        objects = CustomUserManager()
        USERNAME_FIELD = 'username'
    

  同时在settings.py中指定自定义用户模型：

  AUTH_USER_MODEL = 'your_app_name.CustomUser'
  

3. 自定义Admin类隐藏了权限/组字段 #

如果自定义了UserAdmin或GroupAdmin类，未在fieldsets或list_display中包含权限、组相关字段，会导致对应内容不显示。

• 解决：检查自定义Admin类，确保权限相关字段被包含：

from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

class CustomUserAdmin(UserAdmin):
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('权限设置', {'fields': ('is_active', 'is_staff', 'is_superuser', 'groups', 'user_permissions')}),
        # 其他字段组配置
    )

admin.site.register(CustomUser, CustomUserAdmin)

4. 数据库迁移未完成 #

修改用户模型或权限配置后未执行迁移，会导致数据库缺少相关表或字段，引发显示异常。

• 解决：执行迁移命令同步数据库：

python manage.py makemigrations
python manage.py migrate

5. 缓存干扰 #

浏览器缓存或Django缓存可能导致页面显示异常，无法读取最新的权限、组数据。

• 解决：
  • 强制刷新浏览器页面（Ctrl+F5），清空浏览器缓存
  • 若使用Django缓存，执行命令清除缓存：

    python manage.py clearcache
    

  （无clearcache命令时，可重启服务或通过缓存API手动清除）

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