Django自定义UserChangeForm移除groups字段并新增Role字段问题咨询

• 核心错误1：CustomUserAdmin中指定表单的属性写错了，Django的ModelAdmin用来关联自定义修改表单的属性是form，你写的change_form是用来指定修改页模板的属性，所以自定义表单根本没加载，修改自然不生效。
• 核心错误2：UserAdmin默认的fieldsets（字段分组配置）、filter_horizontal（多选字段横向展示配置）里都默认包含groups字段，就算表单去掉了该字段，admin的内置配置还是会尝试渲染该字段，也会导致异常或者配置不生效。
• 其他错误：CustomUserChangeForm的Meta中写了fields = ()会清空所有原有字段，没有意义；在CustomUserAdmin的__init__方法中修改父类的list_display属于不必要的操作，直接在子类定义该属性即可。

from django.contrib.auth.forms import UserChangeForm
from django.contrib.auth.admin import UserAdmin
from django.contrib.auth.models import User, Group
from django.contrib import admin
from .models import Role # 确保你已经导入了自定义的Role模型

class CustomUserChangeForm(UserChangeForm):
    class Meta(UserChangeForm.Meta):
        exclude = ('groups',)
        # 如果你想更稳妥的显式指定所有要展示的字段，可以改成下面的写法，替换成你实际需要的字段即可
        # fields = ('username', 'password', 'email', 'first_name', 'last_name', 'is_active', 'is_staff', 'is_superuser', 'user_role', 'user_permissions', 'last_login', 'date_joined')

class CustomUserAdmin(UserAdmin):
    # 修正为form属性，关联自定义表单
    form = CustomUserChangeForm
    # 直接定义列表展示字段，不需要在__init__中修改
    list_display = ('username', 'is_active', 'email', 'date_joined', 'user_role', 'is_staff', 'is_superuser')
    # 重写fieldsets，移除groups配置，添加自定义的user_role字段
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('个人信息', {'fields': ('first_name', 'last_name', 'email')}),
        ('权限配置', {'fields': ('is_active', 'is_staff', 'is_superuser', 'user_permissions', 'user_role')}),
        ('日期信息', {'fields': ('last_login', 'date_joined')}),
    )
    # 重写filter_horizontal，移除groups，只保留用户权限配置
    filter_horizontal = ('user_permissions',)

class RoleAdmin(admin.ModelAdmin):
    fields = ('name', 'role_permissions')

admin.site.unregister(Group)
admin.site.unregister(User)
admin.site.register(Role, RoleAdmin)
admin.site.register(User, CustomUserAdmin)

• 如果你的User模型是通过AbstractUser扩展的，确认已经在模型中添加了user_role外键字段关联Role模型，并且已经执行了迁移操作。
• 如果你的用户扩展是通过一对一外键关联的独立Profile模型存储角色字段，需要在CustomUserChangeForm中手动添加对应角色字段，并且在CustomUserAdmin中添加对应的字段保存逻辑。

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