Django自定义认证后端失效：邮箱登录功能无法正常使用

问题原因 #

• 自定义认证后端的authenticate方法签名不符合Django规范，缺少request参数，导致后端未被正确触发
• 异常捕获范围过大，可能掩盖实际错误
• 密码验证逻辑存在冗余判断

修复认证后端代码（authentication.py） #

from django.contrib.auth import get_user_model
User = get_user_model()

class CustomAuthBackend:
    def authenticate(self, request, username=None, password=None):
        # 提前校验必填参数
        if not username or not password:
            return None
        
        try:
            # 通过邮箱查找用户
            user = User.objects.get(email=username)
        except User.DoesNotExist:
            # 邮箱不存在则返回，交由其他后端处理
            return None
        
        # 验证密码并返回用户对象
        return user if user.check_password(password) else None

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

关键优化点 #

1. 修正方法签名：添加request作为authenticate的第一个参数，匹配Django认证后端的要求，确保后端能被系统正确调用。
2. 精准异常处理：仅捕获User.DoesNotExist异常，避免隐藏数据库连接错误等其他问题。
3. 简化逻辑：提前判断用户名/密码是否为空，减少无效数据库查询；密码验证逻辑更简洁。
4. 邮箱唯一性保障：确保用户模型中email字段设置unique=True，避免get()方法抛出MultipleObjectsReturned异常。若无法保证唯一性，可将get()替换为filter(email=username).first()。

确认配置正确性 #

settings.py中的认证后端顺序无需调整，当前配置可保证手机号登录由默认后端处理，邮箱登录由自定义后端处理：

AUTHENTICATION_BACKENDS = [
    "django.contrib.auth.backends.ModelBackend",
    "accounts.authentication.CustomAuthBackend",
]

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