移除Django Admin的Groups表时出现NotRegistered错误，如何解决？

问题场景 #

尝试移除Django Admin后台中的Groups表时，触发错误：

django.contrib.admin.sites.NotRegistered: The model Group is not registered

无论在已有开发项目还是新建Django项目中按教程操作，都可能遇到该问题。

核心原因 #

Django默认通过django.contrib.auth.admin模块自动注册Group模型，但如果你的代码执行时机早于该模块的加载，或者项目中自定义了Auth Admin逻辑导致Group未被注册，直接调用admin.site.unregister(Group)就会触发未注册错误。

解决方案 #

方案1：先判断注册状态再卸载 #

在项目的admin.py中，先检查Group是否已注册，再执行卸载操作：

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

# 先确认Group已注册，再执行卸载
if Group in admin.site._registry:
    admin.site.unregister(Group)

这种方式能兼容绝大多数场景，不管Group是否已被默认注册，都不会触发错误。

方案2：利用AppConfig的ready方法延迟执行 #

如果是新建项目或代码执行时机过早的问题，可以将卸载逻辑放到App的ready()方法中（该方法在App完全加载、所有Admin注册完成后执行）：

1. 打开App目录下的apps.py，修改AppConfig类：

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

class YourAppConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'your_app_name'  # 替换为你的App名称

    def ready(self):
        # 在App加载完成后执行Group卸载
        if Group in admin.site._registry:
            admin.site.unregister(Group)

2. 确保在settings.py的INSTALLED_APPS中使用自定义的AppConfig：

INSTALLED_APPS = [
    # 替换默认的'app_name'为自定义配置
    'your_app_name.apps.YourAppConfig',
    # 其他App...
    'django.contrib.admin',
    'django.contrib.auth',
    # ...
]

方案3：完全自定义Auth Admin（进阶） #

如果项目不需要django.contrib.auth自带的Admin配置，可以自行注册User模型，不依赖默认的Auth Admin：

from django.contrib import admin
from django.contrib.auth.models import User, Group
from django.contrib.auth.admin import UserAdmin

# 先卸载默认的User和Group注册（如果存在）
if User in admin.site._registry:
    admin.site.unregister(User)
if Group in admin.site._registry:
    admin.site.unregister(Group)

# 自定义UserAdmin并注册
class CustomUserAdmin(UserAdmin):
    # 自定义配置，比如修改显示字段、权限等
    pass

admin.site.register(User, CustomUserAdmin)
# 不注册Group，即可在Admin后台隐藏Groups表

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