Django自定义UserManager在admin管理面板中未被调用问题

排查步骤 #

• 确认settings.py中AUTH_USER_MODEL配置是否正确，需填写为[你的应用名].[自定义用户类名]，例如AUTH_USER_MODEL = "users.User"，如果配置错误，get_user_model()会获取到错误的用户模型，自然不会触发自定义管理器逻辑。
• 检查自定义UserManager是否同时实现了create_user和create_superuser两个方法，Admin站点创建超级用户时默认调用create_superuser方法，仅实现create_user会导致逻辑回退到父类BaseUserManager的默认实现。
• 检查UserAdmin类是否重写了save_model、add_view等方法，重写后的逻辑如果硬编码调用了默认User模型的管理器，或者没有显式调用当前模型的objects管理器方法，会跳过自定义Manager。
• 检查是否存在动态覆盖用户模型objects属性的代码，例如User.add_to_class("objects", OtherManager)这类逻辑会覆盖模型类中定义的自定义管理器。
• 检查UserAdmin的add_fieldsets配置是否包含自定义用户模型的所有必填字段，缺失必填字段会导致默认创建逻辑异常中断，不会走到自定义Manager的调用逻辑。

解决方法 #

1. 补全UserManager的必要方法，示例代码如下：

class UserManager(BaseUserManager):
    def create_user(self, username, password=None, **extra_fields):
        if not username:
            raise ValueError("用户名不能为空")
        # 统一用self.model获取关联的用户模型，避免硬编码
        user = self.model(username=username, **extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

    def create_superuser(self, username, password=None, **extra_fields):
        extra_fields.setdefault("is_staff", True)
        extra_fields.setdefault("is_superuser", True)

        if not extra_fields["is_staff"]:
            raise ValueError("超级用户必须开启is_staff权限")
        if not extra_fields["is_superuser"]:
            raise ValueError("超级用户必须开启is_superuser权限")
        
        return self.create_user(username, password, **extra_fields)

2. 修正UserAdmin的相关逻辑，如果重写了save_model方法，需显式调用自定义管理器的创建方法，示例如下：

from django.contrib import admin
from django.contrib.auth.admin import BaseUserAdmin
from django.contrib.auth import get_user_model

User = get_user_model()

class UserAdmin(BaseUserAdmin):
    # 保证新增用户表单包含所有必填字段
    add_fieldsets = (
        (None, {
            'classes': ('wide',),
            'fields': ('username', 'password1', 'password2', '其他必填字段'),
        }),
    )

    def save_model(self, request, obj, form, change):
        if not change:
            # 新增用户时调用自定义管理器的创建方法
            obj = User.objects.create_user(
                username=form.cleaned_data['username'],
                password=form.cleaned_data['password1'],
                # 其余表单字段按需传递
                **{k:v for k,v in form.cleaned_data.items() if k not in ['password1', 'password2']}
            )
        else:
            super().save_model(request, obj, form, change)

admin.site.register(User, UserAdmin)

3. 删除所有动态覆盖用户模型objects管理器的代码，保证模型类中objects = UserManager()的定义生效。
4. 确认AUTH_USER_MODEL配置无拼写错误，指向你自定义的用户模型。

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