Django中自定义Permissions与Groups模型的使用问题求助

一、自定义Permission和Group模型的正确方式 #

Django允许通过配置替换内置的Permission和Group模型，无需修改源码，以下是具体步骤：

1. 自定义Permission模型 #

在你项目的app下的models.py中定义扩展模型，继承内置Permission并添加自定义字段：

from django.db import models
from django.contrib.auth.models import Permission as BasePermission

class CustomPermission(BasePermission):
    # 添加你的两个额外字段
    extra_field1 = models.CharField(max_length=100, blank=True)
    extra_field2 = models.BooleanField(default=False)

    class Meta:
        proxy = False  # 非代理模型才能添加字段
        db_table = 'auth_permission'  # 复用原有auth_permission表，避免数据迁移问题
        verbose_name = '自定义权限'
        verbose_name_plural = '自定义权限列表'

然后在项目settings.py中指定自定义模型：

AUTH_PERMISSION_MODEL = '你的app名.CustomPermission'

2. 自定义Group模型（解决local fields cannot replace existing错误） #

不能直接继承内置Group并重写permissions字段，需自行实现兼容接口的Group模型，关联到自定义Permission：

from django.db import models
from django.utils.translation import gettext_lazy as _

class CustomGroup(models.Model):
    name = models.CharField(_('名称'), max_length=150, unique=True)
    # 关联自定义Permission模型
    permissions = models.ManyToManyField(
        '你的app名.CustomPermission',
        verbose_name=_('权限'),
        blank=True,
    )
    # 添加你的四个额外字段
    extra_field_a = models.CharField(max_length=200, blank=True)
    extra_field_b = models.IntegerField(default=0)
    extra_field_c = models.DateTimeField(null=True, blank=True)
    extra_field_d = models.TextField(blank=True)

    class Meta:
        verbose_name = '自定义用户组'
        verbose_name_plural = '自定义用户组列表'

    def __str__(self):
        return self.name

同样在settings.py中指定：

AUTH_GROUP_MODEL = '你的app名.CustomGroup'

二、让User模型使用新的Group和Permission模型 #

1. 使用内置User/AbstractUser的情况 #

只要在settings.py中配置了AUTH_GROUP_MODEL和AUTH_PERMISSION_MODEL，Django会自动让内置User或继承AbstractUser的自定义User模型的groups、user_permissions字段关联到你的新模型，无需额外修改。

2. 自定义AbstractBaseUser的情况 #

如果是完全自定义的User模型（继承AbstractBaseUser），需要手动添加关联字段：

from django.db import models
from django.contrib.auth.models import AbstractBaseUser, BaseUserManager

class CustomUserManager(BaseUserManager):
    # 实现用户管理器逻辑（如创建普通用户、超级用户）
    def create_user(self, email, password=None, **extra_fields):
        if not email:
            raise ValueError('必须提供邮箱')
        email = self.normalize_email(email)
        user = self.model(email=email, **extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

class CustomUser(AbstractBaseUser):
    email = models.EmailField(unique=True)
    is_active = models.BooleanField(default=True)
    is_staff = models.BooleanField(default=False)

    # 关联自定义Group和Permission
    groups = models.ManyToManyField(
        '你的app名.CustomGroup',
        verbose_name=_('用户组'),
        blank=True,
        related_name="user_set",
        related_query_name="user",
    )
    user_permissions = models.ManyToManyField(
        '你的app名.CustomPermission',
        verbose_name=_('用户权限'),
        blank=True,
        related_name="user_set",
        related_query_name="user",
    )

    USERNAME_FIELD = 'email'
    objects = CustomUserManager()

三、迁移与Admin配置 #

1. 数据库迁移 #

• 新项目直接执行迁移命令即可：

python manage.py makemigrations
python manage.py migrate

• 已有项目需手动迁移原有Group和Permission数据：编写数据迁移脚本，将auth_group、auth_group_permissions表的数据同步到新表中。

2. Admin后台配置 #

要在Admin中管理自定义模型，需注册并自定义Admin类：

from django.contrib import admin
from django.contrib.auth.admin import GroupAdmin as BaseGroupAdmin
from .models import CustomGroup, CustomPermission

class CustomGroupAdmin(BaseGroupAdmin):
    fieldsets = (
        (None, {'fields': ('name', 'extra_field_a', 'extra_field_b')}),
        (_('权限'), {'fields': ('permissions',)}),
    )

admin.site.register(CustomGroup, CustomGroupAdmin)
admin.site.register(CustomPermission)

四、扩展模型方法的规范方式 #

无需修改Django源码，直接在自定义模型中添加方法即可：

class CustomGroup(models.Model):
    # ... 已有字段

    def get_permission_count(self):
        """自定义方法：返回用户组拥有的权限数量"""
        return self.permissions.count()

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