Django配置大小写不敏感UniqueConstraint报models.E012错误

这个错误的核心是UniqueConstraint的参数使用错误：

• fields参数只接受模型上真实存在的字段名（字符串格式），框架会直接把传入的内容当做字段名去模型定义里查找。你把Lower('name')表达式放在这个位置，Django会去找名为Lower(F(name))的字段，自然找不到，就抛出了字段不存在的E012错误。
• 所有基于数据库函数的表达式约束，都需要通过UniqueConstraint的expressions参数传入，这个参数是Django 2.2版本为了支持函数类约束专门新增的，不能和fields参数混用。

通用兼容写法（支持Django 2.2及以上所有版本） #

将小写转换的函数表达式从fields参数移动到expressions参数下即可，修正后的完整模型代码如下：

from django.db import models
from django.db.models.functions import Lower


class Tag(models.Model):
    name = models.CharField(max_length=30)

    class Meta:
        constraints = [
            models.UniqueConstraint(
                expressions=[Lower('name')],
                name='unique_lower_tag_name'
            ),
        ]

修改完成后重新执行python manage.py makemigrations和python manage.py migrate命令，即可成功生成数据库层面的函数唯一约束，自动拦截转小写后重复的标签名称。

补充优化建议 #

• 上述约束是数据库层面的强制校验，插入重复数据时会直接抛出IntegrityError。如果需要在表单、序列化器校验阶段提前返回友好的错误提示，可以额外给模型添加clean方法，提前做小写重名的逻辑校验。
• 如果当前使用的数据库对应字段本身配置了大小写不敏感的排序规则（比如MySQL默认的utf8_general_ci、PostgreSQL的citext类型），直接给name字段设置unique=True即可实现大小写不敏感的唯一校验，不需要额外添加函数约束，查询和写入性能更高。

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