Django中firstName__contains查询返回空QuerySet但原生SQL执行正常

可能的原因 #

• 字段名映射不匹配：Django ORM默认会将驼峰格式的模型字段名转换为小写下划线格式存储到数据库，如果你没有在模型字段中显式指定db_column为firstName，ORM生成的SQL实际会查询first_name字段，和你手动写的SQL查询字段不一致，自然返回空结果。
• 大小写敏感规则不一致：Django的__contains查询默认是大小写敏感的，而你使用的数据库如果配置了大小写不敏感的排序规则（collation），原生LIKE语句会忽略大小写匹配。比如数据库中存储的是myname，大小写敏感的__contains查询MyName会匹配失败，而原生LIKE可以匹配成功。
• 数据库连接不一致：Django配置的数据库连接和你登录dbshell使用的连接不是同一个库/实例，比如ORM连的是未同步数据的开发库，dbshell连的是有数据的测试库，或是读写分离配置下查询请求路由到了无数据的从库。
• 字符串编码/不可见字符问题：查询的字符串中存在肉眼不可见的特殊字符、全角半角差异或编码不一致，导致ORM的查询条件和实际存储的内容无法匹配，但你手动写SQL时输入的字符串是正确的。

解决方案 #

1. 首先验证ORM生成的实际SQL是否和预期一致，执行如下代码打印生成的SQL：

qs = ModelName.objects.filter(firstName__contains="MyName")
print(qs.query)

对比打印出的SQL的查询字段、条件值是否和你手动执行的SQL完全一致。
2. 如果是字段名映射问题：在模型字段中显式指定数据库字段名即可：

# 模型定义中添加db_column参数
firstName = models.CharField(max_length=你的字段长度, db_column='firstName')

3. 如果是大小写敏感问题：需要大小写不敏感匹配时替换__contains为__icontains：

ModelName.objects.filter(firstName__icontains="MyName")

如果需要强制大小写敏感，调整对应表的排序规则为大小写敏感即可。
4. 如果是数据库连接问题：检查settings.py中的DATABASES配置，确认连接的库实例、库名、表名和dbshell中操作的完全一致，排查读写分离路由逻辑的错误。
5. 如果是编码问题：分别打印查询字符串和数据库中对应字段值的repr()结果，排查不可见字符和编码差异，调整查询字符串即可。

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