Django预定义带自定义权限的用户组：初始化最佳实践咨询

我之前在好几个Django项目里都碰到过这种需求——每次重置数据库后，手动在Admin里配置用户组和自定义权限真的太烦了！下面是我踩过坑后总结的最佳实践，刚好覆盖你问的预定义信息存放和写入时机这两个核心点：

一、预定义信息的存放位置 #

最清晰且易维护的方式是单独存放业务相关的权限映射配置，而不是混在settings.py或者业务代码里：

• 建议在对应业务app下创建一个permissions_config.py文件，把组名和对应的权限codename做成字典映射，示例如下：

# myapp/permissions_config.py
GROUP_PERMISSIONS = {
    # 组名: [权限codename列表]
    '内容编辑': [
        'myapp.add_post',
        'myapp.change_post',
        'myapp.view_post',
    ],
    '内容审核员': [
        'myapp.view_post',
        'myapp.change_post_status',
        'myapp.delete_post',
    ],
    '超级管理员': [
        # 如果需要给组分配当前app下所有权限，可以用逻辑过滤，不建议直接写*
        # 后续在写入逻辑里通过app_label匹配即可
    ]
}

• 为什么不放在settings.py？因为settings是项目级的全局配置，而权限组通常是和具体业务app绑定的，放在对应app里更模块化，后续如果要复用这个app到其他项目，直接带走配置就行。

二、写入数据库的时机（按推荐度排序） #

1. 自定义Django管理命令（最推荐） #

写一个专属的manage.py命令，既能手动触发，也能集成到CI/CD脚本或者数据库重置后的自动化流程里，灵活性拉满。

步骤如下：

1. 在app下创建management/commands目录（需要有__init__.py文件）
2. 编写命令文件setup_groups.py：

# myapp/management/commands/setup_groups.py
from django.core.management.base import BaseCommand
from django.contrib.auth.models import Group, Permission
from myapp.permissions_config import GROUP_PERMISSIONS

class Command(BaseCommand):
    help = '一键初始化预定义用户组及对应权限'

    def handle(self, *args, **options):
        for group_name, perm_codenames in GROUP_PERMISSIONS.items():
            # 用get_or_create避免重复创建
            group, created = Group.objects.get_or_create(name=group_name)
            
            if created:
                self.stdout.write(self.style.SUCCESS(f"成功创建用户组: {group_name}"))
            else:
                self.stdout.write(f"用户组 {group_name} 已存在，将更新权限")

            # 处理权限列表
            target_permissions = []
            for codename in perm_codenames:
                try:
                    perm = Permission.objects.get(codename=codename)
                    target_permissions.append(perm)
                except Permission.DoesNotExist:
                    self.stderr.write(self.style.WARNING(f"警告：权限 {codename} 不存在，已跳过"))
            
            # 支持给组分配当前app下所有权限的逻辑
            if group_name == '超级管理员':
                # 追加当前app下所有权限
                app_perms = Permission.objects.filter(content_type__app_label='myapp')
                target_permissions.extend(app_perms)
            
            # 更新组的权限（set方法会替换原有权限，避免重复添加）
            group.permissions.set(target_permissions)
            self.stdout.write(self.style.SUCCESS(f"已更新用户组 {group_name} 的权限"))

3. 使用时直接运行：

python manage.py setup_groups

这个方案的好处是完全可控，不会在Django启动或者迁移时意外触发，适合频繁重置数据库的开发场景。

2. 结合数据迁移（适合基础必存数据） #

如果这些用户组是项目必须的基础数据（比如生产环境也需要默认存在），可以把创建逻辑写在数据迁移文件里，这样每次migrate都会自动执行：

1. 生成空迁移文件：

python manage.py makemigrations myapp --empty

2. 编辑生成的迁移文件，添加创建逻辑：

from django.db import migrations
from django.contrib.auth.models import Group, Permission

def setup_default_groups(apps, schema_editor):
    # 注意：迁移中要使用apps.get_model，不能直接导入模型
    Group = apps.get_model('auth', 'Group')
    Permission = apps.get_model('auth', 'Permission')

    GROUP_PERMISSIONS = {
        '内容编辑': ['myapp.add_post', 'myapp.change_post', 'myapp.view_post'],
        '内容审核员': ['myapp.view_post', 'myapp.change_post_status'],
    }

    for group_name, perm_codenames in GROUP_PERMISSIONS.items():
        group, _ = Group.objects.get_or_create(name=group_name)
        permissions = Permission.objects.filter(codename__in=perm_codenames)
        group.permissions.add(*permissions)

class Migration(migrations.Migration):
    dependencies = [
        ('myapp', '0001_initial'),  # 依赖你app的初始迁移
    ]

    operations = [
        migrations.RunPython(setup_default_groups),
    ]

这个方案的缺点是后续修改权限组需要新增迁移文件，灵活性不如管理命令，但胜在和数据库迁移强绑定，不会遗漏基础数据。

3. AppConfig.ready()方法（谨慎使用） #

可以把写入逻辑放在app的ready()方法里，让Django启动服务时自动执行，但要注意Django启动时可能多次调用ready方法，而且如果数据库还未初始化（比如第一次migrate前），会抛出错误，所以需要加容错处理：

# myapp/apps.py
from django.apps import AppConfig
from django.contrib.auth.models import Group, Permission
from django.db.utils import DatabaseError
from myapp.permissions_config import GROUP_PERMISSIONS

class MyappConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'myapp'

    def ready(self):
        try:
            # 先检查Group表是否存在，避免数据库未初始化时报错
            if Group._meta.db_table in self.connection.introspection.table_names():
                for group_name, perm_codenames in GROUP_PERMISSIONS.items():
                    group, _ = Group.objects.get_or_create(name=group_name)
                    # 权限处理逻辑和管理命令里的一致
                    # ...
        except DatabaseError:
            # 数据库未准备好，跳过执行
            pass

这个方案适合开发环境快速初始化，但不推荐在生产环境使用，容易出现预期外的问题。

额外实用建议 #

• 始终用get_or_create来创建组，不管运行多少次都不会生成重复数据
• 权限codename可以通过python manage.py showmigrations或者直接查看auth_permission表获取，或者在Admin的权限页面查看
• 如果需要给组分配跨app的权限，只需要在权限列表里加上对应app的codename即可（比如auth.change_user）
• 测试环境中，可以在测试用例的setUp()方法里调用这个初始化逻辑，保证测试数据一致

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