Django模型重命名后出现重复权限问题咨询

权限字段含义说明 #

你看到的权限条目三个部分分别是：

• deliveryorder：对应你的Django应用名称（即INSTALLED_APPS中注册的应用标识）
• delivery order form：模型类的可读名称（verbose_name），由Django自动将模型类名DeliveryOrderForm转换为空格分隔的友好名称
• can add delivery order form：具体权限动作，格式为can <操作> <模型可读名称>，Django会为每个模型自动生成add/change/delete/view四类基础权限，这部分就是权限的操作描述

重复权限的原因 #

你提到模型从DeliveryOrder重命名为DeliveryOrderForm，但Django不会自动清理数据库中旧模型的权限记录。旧模型DeliveryOrder生成的权限（比如can add delivery order）会保留在auth_permission表中，新模型DeliveryOrderForm又生成了一套新权限，最终导致Admin中显示重复条目。

解决方法 #

方法1：手动清理数据库 #

直接操作数据库的auth_permission表，删除对应旧模型的权限记录：

• 筛选条件：content_type_id对应旧模型的内容类型（可通过django_content_type表查询app_label=deliveryorder且model=deliveryorder的条目ID），或者直接查找name包含delivery order且codename为add_deliveryorder/change_deliveryorder等旧模型权限的记录，删除即可。

方法2：通过自定义管理命令自动清理 #

编写一个Django管理命令批量清理无效权限：

from django.core.management.base import BaseCommand
from django.contrib.auth.models import Permission
from django.apps import apps

class Command(BaseCommand):
    help = '清理系统中无效的模型权限'

    def handle(self, *args, **options):
        # 收集所有当前已注册模型的有效权限codename
        valid_codenames = set()
        for model in apps.get_models():
            model_name = model._meta.model_name
            for action in ['add', 'change', 'delete', 'view']:
                valid_codenames.add(f"{action}_{model_name}")
        
        # 删除不在有效列表中的权限
        invalid_perms = Permission.objects.exclude(codename__in=valid_codenames)
        deleted_count = invalid_perms.count()
        invalid_perms.delete()
        self.stdout.write(self.style.SUCCESS(f"成功删除{deleted_count}条无效权限"))

将这个文件保存到应用的management/commands/cleanup_permissions.py目录下（需提前创建management和commands文件夹，并添加__init__.py），然后执行命令：

python manage.py cleanup_permissions

后续建议 #

如果之后需要再次修改模型名称，建议：

1. 先清理旧模型对应的权限记录
2. 若不需要修改数据库表名，可通过class Meta中的db_table参数保持表名不变，减少遗留问题

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