在Django中使用邮箱登录：找不到相关配置设置怎么办？

看起来你卡在了Django默认认证系统的逻辑上——默认Django是用username而不是邮箱来做用户认证的，所以直接传邮箱给authenticate()肯定行不通。我来一步步帮你理清问题和解决办法：

先修正你现有代码里的小错误 #

你的register视图里有个明显的笔误：authenticate(email=mail, password=raw_password)里的mail应该是email（你前面定义的变量是email = form.cleaned_data.get('email')）。不过这只是小问题，核心问题还是认证逻辑不支持邮箱登录。

核心解决方案：让Django支持邮箱认证 #

要实现邮箱密码登录，有两种常用方式，选一种适合你的：

方式1：自定义认证后端（无需修改用户模型） #

这是最快捷的方案，不需要改动默认的用户模型，只需要新增一个认证后端来支持邮箱匹配：

1. 在你的app目录下创建backends.py文件，写入以下代码：

from django.contrib.auth import get_user_model
from django.contrib.auth.backends import ModelBackend

class EmailBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        UserModel = get_user_model()
        try:
            # 通过邮箱查找用户
            user = UserModel.objects.get(email=username)
        except UserModel.DoesNotExist:
            return None
        else:
            # 验证密码是否正确
            if user.check_password(password):
                return user
        return None

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

2. 在项目的settings.py里配置这个后端，添加到认证后端列表：

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',  # 保留默认后端，兼容原有的username登录
    '你的app名称.backends.EmailBackend',  # 替换成你的app实际名称
]

方式2：自定义用户模型（彻底用邮箱替代Username） #

如果你希望完全抛弃username，让邮箱成为用户的唯一标识，可以自定义用户模型：

1. 在你的app的models.py里创建自定义用户模型：

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

class CustomUser(AbstractUser):
    # 移除默认的username字段
    username = None
    # 设置邮箱为唯一字段
    email = models.EmailField(unique=True, verbose_name='邮箱')

    # 指定用邮箱作为用户认证的唯一标识
    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = []

    def __str__(self):
        return self.email

2. 在settings.py里配置自定义用户模型：

AUTH_USER_MODEL = '你的app名称.CustomUser'

3. 执行数据库迁移：

python manage.py makemigrations
python manage.py migrate

这种方式需要注意：最好在项目初始阶段就配置，如果已经创建了数据库再改，需要做额外的数据迁移处理，相对麻烦一些，但逻辑更清晰。

修正注册和登录视图 #

不管用哪种方式，你都需要调整视图逻辑来适配邮箱认证：

修正注册视图 #

首先，默认的UserCreationForm是没有邮箱字段的，你需要自定义注册表单：
在app目录下创建forms.py：

from django.contrib.auth.forms import UserCreationForm
from django.contrib.auth import get_user_model

class RegistrationForm(UserCreationForm):
    class Meta:
        model = get_user_model()
        # 如果用方式1，保留username字段；方式2的话只需要email和密码字段
        fields = ('email', 'username', 'password1', 'password2')  # 方式1的配置
        # fields = ('email', 'password1', 'password2')  # 方式2的配置

然后更新register视图：

from django.contrib.auth import authenticate, login
from django.shortcuts import render, redirect
from .forms import RegistrationForm

def register(request):
    if request.method == 'POST':
        form = RegistrationForm(request.POST)
        if form.is_valid():
            user = form.save()
            email = form.cleaned_data.get('email')
            raw_password = form.cleaned_data.get('password1')
            # 方式1：用email作为username参数传给authenticate
            user = authenticate(username=email, password=raw_password)
            # 方式2：直接传email参数（因为USERNAME_FIELD是email）
            # user = authenticate(email=email, password=raw_password)
            login(request, user)
            return redirect('accounts:view_profile')
    else:
        form = RegistrationForm()
    return render(request, 'accounts/reg_form.html', {'form': form})

编写登录视图 #

你已经有了login.html，但还需要对应的登录视图：

from django.contrib.auth import authenticate, login
from django.shortcuts import render, redirect

def user_login(request):
    if request.method == 'POST':
        email = request.POST.get('email')
        password = request.POST.get('password')
        # 方式1：用email作为username参数
        user = authenticate(username=email, password=password)
        # 方式2：直接传email参数
        # user = authenticate(email=email, password=password)
        if user is not None:
            login(request, user)
            return redirect('你的成功跳转URL')  # 替换成实际的跳转链接
        else:
            # 登录失败返回错误信息
            return render(request, 'accounts/login.html', {'error': '邮箱或密码错误'})
    else:
        return render(request, 'accounts/login.html')

配置路由 #

最后别忘了在app的urls.py里添加登录路由：

from django.urls import path
from . import views

app_name = 'accounts'
urlpatterns = [
    path('register/', views.register, name='register'),
    path('login/', views.user_login, name='login'),
    # 其他路由...
]

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