Django 2.0替换内置Auth模型遇OperationalError，如何适配现有表？

这个问题其实是因为你对Django自定义用户模型的基类特性理解得不够透彻，咱们一步步来拆解解决：

首先得搞清楚为什么会报错：当你继承AbstractUser时，这个抽象基类本身就包含了Django认证系统依赖的一系列核心字段——比如last_login、is_superuser、username、is_staff等等。Django的认证后端会默认去读取这些字段，你的现有表没有这些字段，自然就会抛出Unknown column的错误。

针对你的需求（想去除username这类无关字段，用现有表实现自定义认证），有两种解决方案，推荐第二种更灵活的方式：

方案一：继续用AbstractUser（适合能调整现有表结构的场景） #

如果你的现有表可以修改结构，那最简单的方式就是把AbstractUser包含的所有字段都添加到现有表中。这些字段包括：

• username、first_name、last_name、email
• is_staff、is_active、is_superuser
• last_login、date_joined

不过这里要注意：如果你本来就想去掉username这类字段，这个方案其实不太合适——因为AbstractUser强制包含了这些字段，就算你不用，也得在表中存在。这时候更推荐方案二。

方案二：用AbstractBaseUser + PermissionsMixin自定义（更灵活，推荐） #

这是Django官方推荐的、用于完全自定义用户模型的方式，你可以只保留业务需要的字段，同时适配现有表。具体步骤如下：

1. 定义自定义用户管理器 #

Django需要一个自定义管理器来处理用户创建逻辑（比如普通用户和超级用户），你需要继承BaseUserManager并实现两个核心方法：

from django.contrib.auth.models import AbstractBaseUser, PermissionsMixin, BaseUserManager
from django.db import models

class CustomUserManager(BaseUserManager):
    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)
        # 设置密码（Django会自动加密存储）
        user.set_password(password)
        user.save(using=self._db)
        return user

    def create_superuser(self, email, password=None, **extra_fields):
        # 超级用户必须拥有后台管理和超级权限
        extra_fields.setdefault('is_staff', True)
        extra_fields.setdefault('is_superuser', 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(email, password, **extra_fields)

2. 定义用户模型 #

继承AbstractBaseUser（提供密码、登录状态等核心认证字段）和PermissionsMixin（提供权限管理相关字段，兼容Django Admin），然后映射你现有表的字段：

class Users(AbstractBaseUser, PermissionsMixin):
    # 映射你现有表的业务字段，比如用邮箱作为登录标识
    email = models.EmailField(unique=True, db_column='user_email')  # db_column对应现有表的列名
    real_name = models.CharField(max_length=50, db_column='name')  # 你的现有表中的姓名字段
    
    # 认证必需的字段（AbstractBaseUser和PermissionsMixin提供）
    is_active = models.BooleanField(default=True, db_column='active')
    is_staff = models.BooleanField(default=False, db_column='staff')
    # 如果现有表的密码列不是默认的password，用db_column映射：
    # password = models.CharField(max_length=128, db_column='user_pwd')

    # 指定自定义管理器
    objects = CustomUserManager()

    # 设置登录用的字段为邮箱（替换默认的username）
    USERNAME_FIELD = 'email'
    # 注册时必填的其他字段（除了邮箱和密码）
    REQUIRED_FIELDS = ['real_name']

    # 必须实现的两个方法（Django认证系统要求）
    def get_full_name(self):
        return self.real_name

    def get_short_name(self):
        return self.real_name

3. 配置项目settings #

在项目的settings.py中指定自定义用户模型：

AUTH_USER_MODEL = 'users.Users'  # 替换成你的app名和模型名

4. 适配现有表结构 #

确保你的现有表包含模型中定义的所有字段，包括：

• 你的业务字段（比如real_name）
• 认证核心字段：password（加密字符串，长度128）、last_login（可空的DateTime类型）、is_active、is_staff、is_superuser
  如果现有表的列名和模型字段名不一致，用db_column参数映射即可。

5. 处理迁移（关键） #

因为是关联现有表，不要直接运行常规迁移（否则Django会尝试创建新表），而是用--fake参数让Django认为迁移已经完成：

python manage.py makemigrations
python manage.py migrate --fake

总结 #

• 如果你只是想替换内置用户模型但保留默认认证字段，用AbstractUser，但必须补全所有它包含的字段到现有表。
• 如果你想彻底自定义字段（比如去掉username），AbstractBaseUser + PermissionsMixin是更灵活的方案，只需要映射现有表的字段并补全认证必需的核心字段即可。

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