Django4函数式唯一约束下Admin提示对象已存在但代码创建正常问题

问题根因 #

你遇到的报错不是Django的bug，是你配置的唯一约束逻辑和预期不符，加上Django Admin的校验特性共同导致的：

• 你定义的第二个函数式唯一约束models.UniqueConstraint(Lower('name'), name='lower_tag_name_idx')是全局级别的小写名称唯一约束：也就是说整个系统里不管属于哪个用户，只要标签名称转小写后重复，就会触发约束报错。而你第一个约束才是用户级别的完全匹配名称唯一。
• Django Admin使用的ModelForm默认只会对unique、unique_together以及基于普通字段的UniqueConstraint做表单层预校验，对于带函数表达式的唯一约束无法提前校验，只能等数据提交到数据库触发完整性错误后，再转换为表单错误返回，也就是你看到的「Tag with this already exists.」提示。
• 你用ORM的Tag.objects.create(...)没报错只是你测试时没有触发全局小写名称重复的场景，如果碰到相同的小写名称，ORM调用同样会抛出IntegrityError。

修复方案 #

如果你的业务需求是每个用户下的标签不区分大小写唯一（也就是同一个用户不能同时有Python和python两个标签，不同用户可以有），把第二个约束修改为带用户维度的联合表达式约束即可：

constraints = [
    models.UniqueConstraint(fields=['user', 'name'], name='unique_tags_per_user'),
    # 新增user字段，约束范围改为同一用户下的名称小写唯一
    models.UniqueConstraint('user', Lower('name'), name='lower_tag_name_per_user_idx')
]

如果确实需要全局标签小写唯一，建议在模型的clean()方法中手动添加校验逻辑，这样不管是Admin操作还是ORM调用都会提前触发校验，返回更清晰的错误提示：

from django.core.exceptions import ValidationError

class Tag(models.Model):
    # 原有字段定义不变
    def clean(self):
        # 手动校验全局小写名称是否重复
        if Tag.objects.filter(name__iexact=self.name).exclude(pk=self.pk).exists():
            raise ValidationError({'name': '已存在相同名称的标签（不区分大小写）'})

关于是否需要提交bug #

不需要，这是Django的预期行为：表达式类型的唯一约束依赖数据库的实现逻辑，Django的表单层无法通用地为所有可能的表达式自动生成预校验规则，只能在数据库层面触发约束后返回错误。

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