Django应用设置邮箱为用户名时大小写敏感问题咨询

这个问题我之前帮不少开发者解决过——首先说结论：默认情况下这是正常行为，但从用户体验和邮箱的行业规则来看，你必须做验证处理。

为什么这是正常行为？ #

Django中，EmailField本质是基于CharField实现的，而数据库默认的字符排序规则（比如MySQL的utf8_bin、PostgreSQL默认的区分大小写规则）会将不同大小写的字符串视为不同值。当你把USERNAME_FIELD设为email后，Django会直接用数据库的规则来判断唯一性，所以test@example.com和TEST@EXAMPLE.COM会被当作两个不同的用户存储，这是框架的默认逻辑，所以是“正常”的，但这完全不符合邮箱的实际使用规则。

为什么必须处理？ #

根据RFC 5321邮件标准，邮箱的本地部分（@前面的内容）是大小写不敏感的（虽然极少数邮件系统支持区分，但主流服务商如Gmail、Outlook都不区分）。如果不处理，会导致用户混淆：比如用户注册时输入了大写邮箱，后续用小写登录却提示“账户不存在”，或者重复注册同一个邮箱的不同大小写版本，这会严重影响用户体验，甚至引发业务逻辑问题。

具体处理方案 #

下面是一套完整的处理流程，确保邮箱在注册、存储、登录全流程中大小写不敏感：

1. 存储时统一转换为小写（核心步骤） #

在保存用户前，自动将邮箱转为小写，确保数据库中存储的都是统一格式的邮箱。你可以通过重写用户模型的save方法实现：

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

class CustomUser(AbstractUser):
    email = models.EmailField(unique=True)
    USERNAME_FIELD = 'email'
    REQUIRED_FIELDS = []  # 根据你的业务需求调整，比如保留username的话填['username']

    def save(self, *args, **kwargs):
        # 保存前将邮箱转为小写
        if self.email:
            self.email = self.email.lower()
        super().save(*args, **kwargs)

也可以用pre_save信号来实现（适合不想修改模型类的场景）：

from django.db.models.signals import pre_save
from django.dispatch import receiver
from .models import CustomUser

@receiver(pre_save, sender=CustomUser)
def normalize_email(sender, instance, **kwargs):
    if instance.email:
        instance.email = instance.email.lower()

2. 登录时支持大小写不敏感匹配 #

即使数据库中存储的是小写邮箱，用户登录时可能输入大写，所以需要修改认证逻辑，将输入的邮箱转为小写后再查询：

from django.contrib.auth.backends import ModelBackend
from .models import CustomUser

class CaseInsensitiveModelBackend(ModelBackend):
    def authenticate(self, request, username=None, password=None, **kwargs):
        try:
            # 用iexact进行不区分大小写的查询
            user = CustomUser.objects.get(email__iexact=username)
        except CustomUser.DoesNotExist:
            return None
        # 验证密码是否正确
        if user.check_password(password):
            return user

然后在settings.py中配置自定义认证后端：

AUTHENTICATION_BACKENDS = [
    'your_app_name.backends.CaseInsensitiveModelBackend',
]

3. 表单验证时提前提示唯一性 #

在注册表单中，提前将输入的邮箱转为小写并检查是否已存在，避免用户输入大写邮箱时收到“邮箱已被注册”的误判：

from django.contrib.auth.forms import UserCreationForm
from django import forms
from .models import CustomUser

class CustomUserCreationForm(UserCreationForm):
    class Meta:
        model = CustomUser
        fields = ['email', 'password1', 'password2']

    def clean_email(self):
        email = self.cleaned_data.get('email')
        if email:
            normalized_email = email.lower()
            if CustomUser.objects.filter(email=normalized_email).exists():
                raise forms.ValidationError("该邮箱已被注册，请直接登录")
            return normalized_email
        return email

总结 #

默认的大小写敏感行为是Django和数据库的固有逻辑，但完全不符合邮箱的实际使用场景。通过上面的三步处理，就能确保无论用户输入什么大小写的邮箱，都能被正确识别为同一个账户，避免不必要的用户困惑。

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