Django自定义用户时出现Admin无_meta属性的AttributeError如何解决？

错误原因分析 #

你遇到的AttributeError: type object 'Admin' has no attribute '_meta'，核心原因有两个：

1. Django认证系统仅支持单用户模型，你设置了AUTH_USER_MODEL = core.Customer，但又试图让Admin作为独立用户模型使用，系统处理Admin时发现它未继承Django模型核心基类（如AbstractBaseUser、AbstractUser），导致缺失_meta属性（这是Django模型的内置元数据属性）。
2. 即便Admin继承了正确基类，Django也无法同时识别两个认证用户模型，会引发系统逻辑冲突。

错误修复（双模型思路，不推荐） #

如果一定要保留两个独立模型，需让Admin正确继承用户基类，并通过自定义认证后端区分：

1. 完善Admin模型定义：

# core/models.py
from django.db import models
from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin, BaseUserManager

class AdminManager(BaseUserManager):
    def create_superuser(self, email, password, **extra_fields):
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', True)
        return self.create_user(email, password, **extra_fields)

    def create_user(self, email, password=None, **extra_fields):
        if not email:
            raise ValueError('必须设置邮箱')
        email = self.normalize_email(email)
        user = self.model(email=email, **extra_fields)
        user.set_password(password)
        user.save(using=self._db)
        return user

class Admin(AbstractBaseUser, PermissionsMixin):
    email = models.EmailField(unique=True)
    is_staff = models.BooleanField(default=True)
    is_active = models.BooleanField(default=True)

    objects = AdminManager()
    USERNAME_FIELD = 'email'

2. 自定义多模型认证后端：

# core/backends.py
from django.contrib.auth.backends import ModelBackend
from .models import Customer, Admin

class MultiModelBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        # 优先验证普通用户
        try:
            user = Customer.objects.get(username=username)
            if user.check_password(password):
                return user
        except Customer.DoesNotExist:
            pass
        # 验证后台管理员
        try:
            user = Admin.objects.get(email=username)
            if user.check_password(password):
                return user
        except Admin.DoesNotExist:
            return None

    def get_user(self, user_id):
        try:
            return Customer.objects.get(pk=user_id)
        except Customer.DoesNotExist:
            try:
                return Admin.objects.get(pk=user_id)
            except Admin.DoesNotExist:
                return None

3. 在settings.py配置认证后端：

AUTHENTICATION_BACKENDS = [
    'core.backends.MultiModelBackend',
]

⚠️ 注意：这种方式会导致admin后台管理混乱、权限系统冲突、第三方库兼容问题，强烈不推荐。

最优实现方式（推荐） #

利用Django内置的单用户模型+权限标识实现需求，无需创建两个独立模型：

1. 自定义Customer模型，添加字段区分用户类型：

# core/models.py
from django.db import models
from django.contrib.auth.models import AbstractUser, BaseUserManager

class CustomUserManager(BaseUserManager):
    def create_user(self, username, email=None, password=None, **extra_fields):
        extra_fields.setdefault('is_staff', False)
        extra_fields.setdefault('is_superuser', False)
        return self._create_user(username, email, password, **extra_fields)

    def create_superuser(self, username, email=None, password=None, **extra_fields):
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', True)
        extra_fields.setdefault('is_admin', True)
        if extra_fields.get('is_staff') is not True:
            raise ValueError('超级用户必须设置is_staff=True')
        if extra_fields.get('is_superuser') is not True:
            raise ValueError('超级用户必须设置is_superuser=True')
        return self._create_user(username, email, password, **extra_fields)

class Customer(AbstractUser):
    # 自定义字段示例
    phone = models.CharField(max_length=11, blank=True)
    # 标识是否为后台管理员
    is_admin = models.BooleanField(default=False)

    objects = CustomUserManager()

2. 在settings.py配置默认用户模型：

AUTH_USER_MODEL = 'core.Customer'

3. 配置admin后台，按字段区分用户权限：

# core/admin.py
from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import Customer

class CustomUserAdmin(UserAdmin):
    list_display = ('username', 'email', 'phone', 'is_admin', 'is_staff', 'is_active')
    list_filter = ('is_admin', 'is_staff', 'is_active')
    fieldsets = (
        (None, {'fields': ('username', 'password')}),
        ('个人信息', {'fields': ('first_name', 'last_name', 'email', 'phone')}),
        ('权限设置', {'fields': ('is_admin', 'is_staff', 'is_active', 'is_superuser', 'groups', 'user_permissions')}),
        ('重要日期', {'fields': ('last_login', 'date_joined')}),
    )

admin.site.register(Customer, CustomUserAdmin)

方案优势 #

• 完全兼容Django原生认证系统，避免双模型带来的所有冲突
• 通过字段标识区分用户类型，逻辑清晰，维护成本低
• 完美支持admin后台、权限系统、session等所有原生功能
• 扩展灵活，新增用户类型只需添加字段或使用权限分组

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