django-allauth邮箱认证失效求助：仅用户名可正常登录

嘿，我之前也碰到过一模一样的问题！你注册功能正常但邮箱登录失败，大概率是配置或表单环节没踩对要点，咱们一步步来排查：

• 核心配置项检查：先确认settings.py里是否开启了邮箱登录支持，这是最容易遗漏的点：

  # 设置认证方式为邮箱（或同时支持邮箱+用户名）
  ACCOUNT_AUTHENTICATION_METHOD = 'email'  # 或者 'username_email' 允许两种方式登录
  ACCOUNT_EMAIL_REQUIRED = True  # 强制注册时填写邮箱
  ACCOUNT_USERNAME_REQUIRED = False  # 如果要完全用邮箱替代用户名，必须设为False
  

  要是你之前只开了邮箱必填，但没把认证方式改成email，那系统还是只会认用户名登录，自然会报密码/邮箱错误。

• 用户模型与数据校验：

  • 如果用了自定义用户模型，确保AUTH_USER_MODEL指向正确，且模型里的email字段设置了unique=True——邮箱作为唯一标识必须是唯一的，不然系统没法准确匹配用户。
  • 去数据库里核对一下用户的email字段：有没有多余空格？大小写是否和用户输入一致？虽然django-allauth默认不区分邮箱大小写，但个别情况下数据库存储的格式问题也会导致匹配失败。

• 登录表单字段校验：
  如果你用了自定义的登录模板，一定要确认用户名/邮箱输入框的name属性是login，而不是email！django-allauth的登录表单里，login字段是通用的，会根据你的配置自动识别输入的是邮箱还是用户名。比如正确的表单代码应该是：

  <div class="form-group">
    <label for="login">邮箱</label>
    <input type="email" name="login" id="login" required>
  </div>
  

  要是你把name改成了email，系统会找不到登录标识，直接判定为账号不存在。

• 认证后端配置：
  检查settings.py里的AUTHENTICATION_BACKENDS，确保包含django-allauth的认证后端，顺序也别搞反了：

  AUTHENTICATION_BACKENDS = [
      'django.contrib.auth.backends.ModelBackend',
      'allauth.account.auth_backends.AuthenticationBackend',
  ]
  

  要是少了allauth的后端，系统只会用django默认的用户名认证逻辑，自然不认邮箱。

• 最后试试重启服务/清缓存：
  有时候配置修改后没生效，可能是缓存的锅。重启django服务器，或者清除浏览器缓存再试试登录。

如果以上步骤都试过还是不行，可以打开django的调试模式，看后台的详细错误日志，或者在登录视图里打印一下请求的POST参数，看看邮箱是否正确传递到了后端。

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