DRF admin面板创建用户未调用自定义User Manager问题求解

AI 小北

2026-10-5

问题原因及排查方案

1 基础配置校验（优先确认）

虽然命令行python manage.py createsuperuser能触发打印说明大部分配置正确，仍需检查自定义用户模型的管理器绑定是否正确：

class CustomUser(AbstractBaseUser, PermissionsMixin):
    # 你的自定义字段定义
    email = models.EmailField(unique=True)
    # 必须显式指定自定义管理器
    objects = MyUserManager()
    # USERNAME_FIELD、REQUIRED_FIELDS等配置
    USERNAME_FIELD = 'email'

2 最常见问题：Admin注册逻辑未适配

这是你遇到的问题的概率最高的原因：
Django默认的ModelAdmin新增实例时，会直接实例化模型、赋值后调用模型的save()方法，不会主动调用自定义管理器的create_user/create_superuser方法。而createsuperuser命令是官方明确实现为调用用户模型管理器的create_superuser方法，因此只有命令行能触发打印。

你需要在应用的admin.py中继承Django自带的UserAdmin注册自定义用户，UserAdmin内部已经封装了创建用户时调用管理器对应方法的逻辑，示例代码如下：

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import CustomUser

class CustomUserAdmin(UserAdmin):
    # 根据你的自定义字段调整新增用户页的字段
    add_fieldsets = (
        (None, {
            'classes': ('wide',),
            'fields': ('email', 'password1', 'password2', 'is_staff', 'is_superuser')}
        ),
    )
    # 按需调整列表页、编辑页的字段配置
    list_display = ('email', 'is_staff', 'is_superuser')
    fieldsets = UserAdmin.fieldsets 

admin.site.register(CustomUser, CustomUserAdmin)

如果你之前是直接用admin.site.register(CustomUser)注册，没有绑定适配的CustomUserAdmin，调整后即可触发管理器的对应方法。