Django设置用户邮箱unique=True导致无邮箱用户创建失败问题

核心问题 #

你碰到的情况主要有两种可能：

• 字段参数设置不全：如果只给email加了unique=True和blank=True，没加null=True，无邮箱用户的邮箱会被存成空字符串''，而不是数据库的NULL值。空字符串是具体有效值，唯一约束会判定重复，导致第二个无邮箱用户创建失败。
• 数据库约束逻辑差异：少数数据库会把NULL当成相同值处理，但主流的PostgreSQL、MySQL都允许多个NULL存在，这种情况概率很低。

解决方法 #

方法一：修正模型字段（推荐） #

给email字段同时加上null=True和blank=True，再用条件唯一约束替代直接的unique=True，只对非空邮箱做唯一性校验：

from django.db import models

class User(models.Model):
    # 其他用户字段...
    email = models.EmailField(blank=True, null=True)

    class Meta:
        constraints = [
            models.UniqueConstraint(
                fields=['email'],
                condition=models.Q(email__isnull=False),
                name='unique_non_empty_email'
            )
        ]

这么设置后，空邮箱（数据库存为NULL）可以创建多个，非空邮箱则不会重复。

方法二：自定义验证逻辑（兼容老版本Django） #

如果用的是Django 2.2以下版本（不支持条件唯一约束），可以在模型的clean方法里手动校验：

from django.db import models
from django.core.exceptions import ValidationError

class User(models.Model):
    email = models.EmailField(blank=True, null=True)

    def clean(self):
        super().clean()
        if self.email:
            # 排除当前用户本身，检查邮箱是否已被使用
            if User.objects.filter(email=self.email).exclude(pk=self.pk).exists():
                raise ValidationError("该邮箱已被占用")

注意：这种方法只在调用full_clean()时生效（比如Django后台、表单提交），直接用create()创建用户可能会绕过验证，最好配合数据库约束一起用。

额外检查项 #

• 查一下数据库里已有的无邮箱用户，email字段是不是''而非NULL，如果是，说明你没加null=True，改完模型后记得执行迁移。
• 迁移后确认数据库的约束已经更新。

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