如何解决Django User Admin中自定义ModelForm的字段缺失错误

你遇到的问题根源是BaseUserAdmin默认配置的fieldsets和自定义表单的字段范围不匹配。当你在get_form里切换表单时，后台依然沿用默认的fieldsets配置，导致它试图渲染表单中不存在的字段，从而抛出字段找不到的错误。

比如普通用户使用排除is_superuser的UserForm时，admin的fieldsets里仍包含is_superuser字段，就会提示该字段不在表单中；反过来排除groups时，fieldsets里的groups字段又无法在表单中找到对应项。

解决方法 #

需要同时重写get_form和get_fieldsets方法，让表单字段和后台显示的字段组保持完全一致：

from django.contrib.auth.admin import BaseUserAdmin
from django.contrib.auth.models import User
from django.forms import ModelForm

class UserForm(ModelForm):
    class Meta:
        model = User
        # 明确指定普通用户可操作的字段，避免exclude带来的歧义
        fields = (
            'username', 'email', 'first_name', 'last_name',
            'is_active', 'is_staff', 'date_joined', 'last_login',
            'password', 'user_permissions'
        )

class SuperUserForm(ModelForm):
    class Meta:
        model = User
        fields = "__all__"

class UserAdmin(BaseUserAdmin):
    inlines = (UserProfileInline,)

    def get_form(self, request, obj=None, **kwargs):
        if request.user.is_superuser:
            kwargs["form"] = SuperUserForm
        else:
            kwargs["form"] = UserForm
        return super().get_form(request, obj, **kwargs)

    def get_fieldsets(self, request, obj=None):
        if request.user.is_superuser:
            # 超级用户沿用默认的全字段分组配置
            return super().get_fieldsets(request, obj)
        else:
            # 普通用户使用和UserForm匹配的字段分组
            return (
                (None, {'fields': ('username', 'password')}),
                ('Personal info', {'fields': ('first_name', 'last_name', 'email')}),
                ('Permissions', {'fields': ('is_active', 'is_staff', 'user_permissions')}),
                ('Important dates', {'fields': ('last_login', 'date_joined')}),
            )

额外优化建议 #

• 优先使用fields明确指定字段，而非exclude，减少和admin默认配置的冲突概率。
• 如果你的UserProfileInline涉及权限敏感字段，可通过重写get_inlines方法控制普通用户是否可见：

  def get_inlines(self, request, obj=None):
      if request.user.is_superuser:
          return self.inlines
      else:
          return []
  

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