Django Filter大小写不敏感查询失效问题及解决方法

原因 #

Django中CharField的默认查询是区分大小写的，数据库会严格匹配字符串的大小写。你数据库中ProjectTask表的team字段存储的是'Backend'，所以用小写的'backend'查询时，无法匹配到对应数据，返回空QuerySet。

解决方案 #

1. 使用不区分大小写的查询方法 #

直接在查询时使用__iexact（精确匹配，忽略大小写）或__icontains（包含匹配，忽略大小写）：

# 精确匹配，忽略大小写，两种输入都能命中
TaskBlockers.objects.filter(task__project=1,task__team__iexact='backend')

如果只需要精确匹配，__iexact比__icontains更高效，因为后者会做包含性检索。

2. 模型层统一存储格式 #

在ProjectTask模型中添加数据清洗逻辑，确保存储team字段时统一为小写（或大写）：

class ProjectTask(models.Model):
    project = models.ForeignKey(Projects,on_delete=models.SET_NULL,null=True)
    team = models.CharField(max_length=10)
    task_title = models.CharField(max_length=200,null=False)
    task_desc = models.TextField(blank=True)
    
    def clean(self):
        # 保存前将team转为小写
        if self.team:
            self.team = self.team.strip().lower()
        super().clean()

之后查询时，不管输入是'Backend'还是'backend'，统一转为小写再查询即可，也能避免大小写不一致的存储问题。

3. 数据库层面设置不区分大小写字段（仅PostgreSQL适用） #

如果使用PostgreSQL数据库，可以使用Django提供的CICharField（大小写不敏感的字符字段），替代普通的CharField：

from django.contrib.postgres.fields import CICharField

class ProjectTask(models.Model):
    project = models.ForeignKey(Projects,on_delete=models.SET_NULL,null=True)
    team = CICharField(max_length=10)
    task_title = models.CharField(max_length=200,null=False)
    task_desc = models.TextField(blank=True)

使用该字段后，所有针对team的查询都会自动忽略大小写，无需额外修改查询语句。

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