如何用抽象类扩展Django默认用户模型，改邮箱登录并保留核心功能

1. 用抽象类扩展User模型并保留所有默认功能 #

要保留Django默认User的密码哈希、验证等所有功能，必须继承AbstractUser而非AbstractBaseUser——AbstractUser已经封装了完整的用户字段（username、email、password等）和核心方法（密码哈希、权限验证等），只需在其基础上添加自定义字段即可。

实现步骤： #

• 在目标app的models.py中定义自定义User模型：

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

class CustomUser(AbstractUser):
    # 添加自定义字段，示例：手机号、头像
    phone_number = models.CharField(max_length=15, blank=True, null=True)
    avatar = models.ImageField(upload_to='avatars/', blank=True, null=True)
    
    # 可选：提前设置邮箱唯一，为后续邮箱登录做准备
    email = models.EmailField(unique=True)

• 在项目根目录的settings.py中指定自定义用户模型（必须在首次迁移前设置，否则会触发数据库冲突）：

AUTH_USER_MODEL = 'your_app_name.CustomUser'

• 执行数据库迁移：

python manage.py makemigrations
python manage.py migrate

通过这种方式定义的CustomUser会完全继承AbstractUser的所有功能：密码自动哈希、check_password()方法、权限系统、会话管理等均可正常运行。

2. 改为邮箱登录并修复功能失效问题 #

若使用抽象类后出现密码哈希、验证失效，大概率是错误继承了AbstractBaseUser而非AbstractUser，或未正确配置认证逻辑。以下是正确的邮箱登录实现方案：

步骤1：调整自定义User模型 #

确保CustomUser继承AbstractUser，并将登录字段改为邮箱：

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

class CustomUser(AbstractUser):
    phone_number = models.CharField(max_length=15, blank=True, null=True)
    avatar = models.ImageField(upload_to='avatars/', blank=True, null=True)
    
    # 指定邮箱作为登录凭证字段
    USERNAME_FIELD = 'email'
    # 移除username的必填要求（AbstractUser默认username为必填，此处设为空列表）
    REQUIRED_FIELDS = []
    
    # 强制邮箱唯一性
    email = models.EmailField(unique=True)
    
    # 可选：自动用邮箱填充username，避免username为空报错
    def save(self, *args, **kwargs):
        if not self.username:
            self.username = self.email
        super().save(*args, **kwargs)

步骤2：自定义登录表单（推荐） #

默认登录表单使用username字段，自定义表单让用户输入邮箱：

from django.contrib.auth.forms import AuthenticationForm
from django import forms

class EmailLoginForm(AuthenticationForm):
    username = forms.EmailField(label='邮箱', widget=forms.EmailInput(attrs={'autofocus': True}))

步骤3：配置登录视图 #

若使用Django自带的LoginView，在URL配置中指定自定义表单：

from django.contrib.auth.views import LoginView
from .forms import EmailLoginForm

urlpatterns = [
    path('login/', LoginView.as_view(form_class=EmailLoginForm), name='login'),
]

关键注意事项： #

• 必须在首次迁移前设置AUTH_USER_MODEL，否则需清空数据库后重新迁移。
• 禁止直接修改Django默认的auth_user表，通过抽象类扩展是官方推荐的标准方式。
• 若之前错误继承AbstractBaseUser，需重新定义模型并确保包含AbstractUser的所有核心字段（如username、is_active、is_staff等），否则会丢失密码哈希、权限管理等核心功能。

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