Django Admin站点忽略自定义UserCreationForm问题求助

看起来你已经搭好了扩展用户信息的基础结构，但Admin页面没生效大概率是几个常见的配置环节没做对，我帮你梳理下排查和修复步骤：

1. 确认是否替换了默认的UserAdmin #

你必须把自定义的UserAdmin注册到Admin站点，替换掉Django默认的User管理类——如果只是写了UserAdmin但没完成注册，肯定不会生效。

比如你的自定义UserAdmin应该继承自官方的UserAdmin，然后按下面的方式注册：

from django.contrib.auth.models import User
from django.contrib.auth.admin import UserAdmin as BaseUserAdmin

class UserProfileAdmin(BaseUserAdmin):
    inlines = (ProfileInline,)
    # 关联自定义的创建表单
    add_form = UserProfileCreationForm
    # 如需调整编辑页面字段，还要配置fieldsets/add_fieldsets

# 先注销默认的UserAdmin，再注册自定义版本
admin.site.unregister(User)
admin.site.register(User, UserProfileAdmin)

2. 检查UserProfile模型的关联是否正确 #

你的UserProfile模型必须和User是一对一关联，且字段名称要和Inline里的fk_name对应：

from django.contrib.auth.models import User
from django.db import models

class UserProfile(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE, related_name='profile')
    phone = models.CharField(max_length=11, blank=True)
    # 其他自定义字段...

你Inline里的fk_name = 'user'是对的，但前提是模型里的外键确实叫user。

3. 完善UserCreationForm的配置 #

自定义的UserProfileCreationForm需要正确继承UserCreationForm，把自定义字段加入表单，还要处理保存逻辑：

class UserProfileCreationForm(UserCreationForm):
    phone = models.CharField(max_length=11, required=False)

    class Meta:
        model = User
        fields = ('username', 'phone', 'password1', 'password2')

    def save(self, commit=True):
        user = super().save(commit=False)
        if commit:
            user.save()
            # 保存用户时同步创建对应的UserProfile实例
            UserProfile.objects.create(user=user, phone=self.cleaned_data['phone'])
        return user

如果表单没把自定义字段加入fields，或者保存时没创建UserProfile，Admin里也不会显示对应的字段。

4. 配置Admin的add_fieldsets（添加用户页面） #

如果是添加用户的页面看不到自定义字段，需要在自定义UserAdmin里配置add_fieldsets，把字段加进去：

class UserProfileAdmin(BaseUserAdmin):
    add_fieldsets = (
        (None, {
            'classes': ('wide',),
            'fields': ('username', 'phone', 'password1', 'password2'),
        }),
    )
    # 若要在编辑页面显示Profile字段，也要调整fieldsets
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('Personal info', {'fields': ('first_name', 'last_name', 'email')}),
        ('Permissions', {'fields': ('is_active', 'is_staff', 'is_superuser', 'groups', 'user_permissions')}),
        ('Important dates', {'fields': ('last_login', 'date_joined')}),
        ('Profile', {'fields': ('phone',)}),
    )
    inlines = (ProfileInline,)
    add_form = UserProfileCreationForm

5. 清除缓存并重启服务 #

有时候浏览器会缓存Admin页面的旧版本，修改代码后记得重启Django服务，然后用隐私模式打开Admin页面，或者清空浏览器缓存再测试。

如果做完这些还是有问题，可以把你的UserProfile模型和完整的UserAdmin代码贴出来，我再帮你排查~

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