Django两种扩展用户模型方案冲突，如何实现唯一邮箱与额外字段？

核心思路 #

放弃一对一关联Account的方式，直接继承AbstractUser自定义用户模型，把需要的额外字段（积分、职业）直接整合到自定义模型中，同时重写email字段设置唯一约束——既实现邮箱唯一性校验，又完成用户字段扩展。

具体实现步骤 #

1. 定义自定义用户模型 #

替换account/models.py中的原有代码，直接扩展AbstractUser：

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

class CustomUser(AbstractUser):
    # 重写email字段，设置唯一约束
    email = models.EmailField(verbose_name="邮箱地址", unique=True)
    # 添加原Account模型的额外字段
    points = models.IntegerField(default=0, verbose_name="积分")
    profession = models.CharField(
        max_length=30, 
        blank=True, 
        null=True,
        choices=[('a', 'a'), ('b', 'b')],
        verbose_name="职业"
    )

    def __str__(self):
        return self.username

2. 配置全局用户模型 #

确保settings.py中指定自定义模型路径：

AUTH_USER_MODEL = 'account.CustomUser'

3. 适配Admin后台 #

修改account/admin.py，让后台支持自定义模型的字段管理：

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

class CustomUserAdmin(UserAdmin):
    # 列表页显示核心字段
    list_display = ('username', 'email', 'points', 'profession', 'is_staff')
    # 编辑页追加自定义字段分组
    fieldsets = UserAdmin.fieldsets + (
        ('额外信息', {'fields': ('points', 'profession')}),
    )
    # 新建用户时可设置自定义字段
    add_fieldsets = UserAdmin.add_fieldsets + (
        ('额外信息', {'fields': ('points', 'profession')}),
    )

admin.site.register(CustomUser, CustomUserAdmin)

4. 解决迁移报错问题 #

你遇到的the model User is not registered错误，是因为项目已基于默认User模型生成过迁移记录，需清理旧迁移后重新初始化：

• 删除项目根目录的db.sqlite3数据库文件（生产环境请先备份）
• 删除所有app下migrations文件夹中，除__init__.py外的所有文件
• 重新执行迁移命令：

python manage.py makemigrations
python manage.py migrate

注意：已上线项目不可直接删库，需编写数据迁移脚本，将原User和Account表的数据同步到新的CustomUser模型中。

原方案问题说明 #

• 一对一关联Account时，新增的email字段属于Account表，无法约束默认User模型的邮箱唯一性；
• 中途切换自定义用户模型时，未清理旧迁移记录，导致Django仍尝试调用已注销的默认User模型，引发报错。

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