Django如何设置字段为不区分大小写的唯一约束

你当前使用的unique=True是区分大小写的原生唯一约束，会将car和cAr判定为不同值，无法满足需求。可以根据你使用的数据库类型，选择以下可靠方案：

数据库层实现（最推荐，无并发校验失效问题） #

数据库层的约束是最终兜底机制，不会出现高并发场景下多请求同时通过校验、插入重复数据的竞态问题。

• 若使用PostgreSQL：
  1. 直接引入Django内置的不区分大小写文本字段CitextField，替换原有普通字符字段：

     # models.py
     from django.db import models
     from django.contrib.postgres.fields import CitextField
     
     class Food(models.Model):
         # 配合unique属性自动实现不区分大小写的唯一约束
         name = CitextField(max_length=100, unique=True)
     
         def __str__(self):
             return self.name
     

  2. 生成并执行迁移时，Django会自动为数据库启用citext扩展，无需手动操作数据库。此时提交任意大小写重复的名称，数据库会直接抛出唯一约束错误，被DRF序列化器自动捕获返回。
• 若使用MySQL：
  通过指定不区分大小写的字段排序规则（排序规则后缀_ci即代表case insensitive），让普通CharField的唯一约束生效为不区分大小写逻辑：

  # models.py
  class Food(models.Model):
      name = models.CharField(
          max_length=100,
          unique=True,
          # 指定不区分大小写的排序规则
          db_collation='utf8mb4_general_ci'
      )
  
      def __str__(self):
          return self.name
  

  生成迁移并应用后，字段的排序规则会被自动修改，数据库层的唯一约束会自动忽略大小写差异。

跨数据库兼容实现方案 #

如果不想绑定特定数据库的专有特性，可以通过ORM自定义校验+函数式唯一索引实现，兼容所有主流关系型数据库：

1. 修改模型配置，移除原有unique=True属性，新增基于小写转换的数据库唯一约束作为兜底：

   # models.py
   from django.db import models
   from django.db.models.functions import Lower
   
   class Food(models.Model):
       name = models.CharField(max_length=100)
   
       class Meta:
           constraints = [
               models.UniqueConstraint(
                   Lower('name'),
                   name='unique_food_name_case_insensitive'
               )
           ]
   
       def __str__(self):
           return self.name
   

2. 在序列化器中新增自定义校验逻辑，提前捕获大小写重复的输入，返回友好的错误提示：

   # serializers.py
   from rest_framework import serializers
   from .models import Food
   
   class FoodSerializer(serializers.ModelSerializer):
       class Meta:
           model = Food
           fields = '__all__'
   
       def validate_name(self, value):
           # 不区分大小写匹配查询是否存在同名数据
           queryset = Food.objects.filter(name__iexact=value)
           # 编辑场景下排除当前正在修改的实例，避免自身值触发误判
           if self.instance:
               queryset = queryset.exclude(pk=self.instance.pk)
           if queryset.exists():
               raise serializers.ValidationError("已存在相同名称的食物，名称校验不区分大小写")
           return value
   

注意：如果数据库中已经存在大小写不同的重复历史数据，需要先清理完重复数据再执行迁移，否则新增唯一约束会执行失败。

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