基于AbstractUser实现Django用户名与邮箱双认证的低改动方案咨询

完全可以在不修改现有用户模型、不破坏原有依赖username的业务逻辑的前提下实现需求，仅需新增一个自定义认证后端，全程改动不超过30行代码。

步骤1：新建自定义认证后端 #

在你的应用目录下新建backends.py文件，写入以下代码：

from django.contrib.auth import get_user_model
from django.contrib.auth.backends import ModelBackend
from django.db.models import Q

User = get_user_model()

class EmailOrUsernameAuthBackend(ModelBackend):
    """支持用户名/邮箱双字段登录的认证后端"""
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            # 同时匹配用户名或邮箱，email__iexact可实现邮箱大小写不敏感匹配
            user = User.objects.get(Q(username=username) | Q(email__iexact=username))
        except User.DoesNotExist:
            return None
        # 校验密码和账号状态，复用Django原生校验逻辑
        if user.check_password(password) and self.user_can_authenticate(user):
            return user
        return None

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

步骤2：修改项目配置 #

打开项目settings.py，添加以下配置，将自定义认证后端加入认证链：

AUTHENTICATION_BACKENDS = [
    # 替换为你自己的应用名
    'your_app_name.backends.EmailOrUsernameAuthBackend',
    # 保留Django原生认证后端作为兜底
    'django.contrib.auth.backends.ModelBackend',
]

步骤3：无需额外改动，直接使用 #

现有登录接口、前端逻辑完全不需要修改：

• 前端登录请求仍然沿用原有参数结构{"username": "用户输入值", "password": "密码"}
• 用户输入用户名或邮箱到账号输入框都可以正常完成认证
• 原有所有依赖username字段的业务逻辑、视图、前端展示完全不受影响

方案优势 #

• 无侵入性：没有修改用户模型，不需要做数据迁移，不会破坏现有逻辑
• 复用性高：完全复用Django原生的密码校验、账号状态校验逻辑，没有额外安全风险
• 改造成本极低：仅需2处小改动，无需调整现有业务代码

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