现有Django应用实现邮箱/用户名双登录时自定义认证后端未调用求助

以下是几个最可能导致你的EmailOrUsernameModelBackend未被触发的原因，按优先级逐一排查：

1. 后端类未继承正确基类 #

你的自定义后端继承自object，但Django要求认证后端必须继承django.contrib.auth.backends.BaseBackend（Django 1.11+）或更早版本的ModelBackend。继承普通object会导致Django无法识别这是合法的认证后端，直接跳过调用。

修改后端类的继承逻辑：

from django.contrib.auth.backends import BaseBackend
from django.contrib.auth.models import User

class EmailOrUsernameModelBackend(BaseBackend):
    # 保留原有的authenticate和get_user方法不变

2. 检查settings.py配置细节 #

• 确认AUTHENTICATION_BACKENDS的路径完全正确：检查应用名authentication是否与实际目录名一致，类名EmailOrUsernameModelBackend拼写（含大小写）是否和定义完全匹配。
• 确保authentication应用已添加到INSTALLED_APPS：

  INSTALLED_APPS = [
      # ...其他应用
      'authentication',
  ]
  

• 排查配置是否被覆盖：检查settings.py后续代码有没有重新赋值AUTHENTICATION_BACKENDS，覆盖了你之前的配置。

3. 确认视图使用正确的authenticate函数 #

检查authentication/views.py中authenticate的导入是否为Django官方提供的：

from django.contrib.auth import authenticate, login

如果导入了自定义的authenticate函数或导入路径错误，会导致无法触发认证后端链。

4. 重启开发服务器 #

Django的settings修改后必须重启服务器才能生效，若修改AUTHENTICATION_BACKENDS后未重启，新配置不会被加载，自定义后端自然不会被调用。

5. 适配Django版本的方法签名 #

若使用Django 1.10及更早版本，authenticate方法要求必须包含request参数，你的当前方法定义缺少该参数会导致无法被调用。修改方法签名：

def authenticate(self, request, username=None, password=None):
    # 原有逻辑保持不变

（Django 1.11+允许省略request，但为兼容性建议加上）

6. 测试场景是否触发自定义后端逻辑 #

Django会按AUTHENTICATION_BACKENDS的顺序依次调用后端，直到有一个返回用户对象。如果测试时用用户名登录，django.contrib.auth.backends.ModelBackend已成功验证并返回用户，自定义后端的authenticate就不会被触发。建议单独用邮箱测试，或暂时移除ModelBackend配置，验证自定义后端是否生效。

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