Django中MySQL的icontains忽略大小写功能失效问题

兄弟，我来帮你捋捋这个问题！看你描述的情况——输入Travel（和数据库完全一致）能搜到，输入travel也能搜到，哪怕用了icontains来做忽略大小写处理？不对，等等，icontains本身就是用来实现忽略大小写搜索的啊，难道你其实想要的是区分大小写的匹配，结果现在不管大小写都能搜到，所以觉得icontains没按你预期的来？

不管怎样，先把最常见的原因和解决方法给你理清楚：

核心问题根源 #

Django的查询方法（比如__icontains、__contains）的大小写敏感性，本质上是由MySQL数据库的**字符集排序规则（Collation）**决定的：

• 如果你的Product表或者title字段用的是不区分大小写的排序规则（比如utf8mb4_general_ci、utf8_general_ci），那__contains和__icontains的效果会差不多，都会忽略大小写；
• 如果用的是区分大小写的排序规则（比如utf8mb4_bin、utf8_bin），那__contains会严格区分大小写，而__icontains会在查询时自动转换为不区分大小写的匹配（依赖Django的处理+数据库支持）。

对应解决方法 #

场景1：你想要「严格区分大小写的搜索」

那别用__icontains，改用__contains，同时确保你的title字段排序规则是区分大小写的：

1. 先检查当前字段的排序规则，登录MySQL执行：

   SHOW FULL COLUMNS FROM your_app_product LIKE 'title';
   

   看Collation列，如果是带bin的就是区分大小写的类型。
2. 如果不是，修改Django模型的字段配置：

   class Product(models.Model):
       title = models.CharField(
           max_length=255,
           db_collation='utf8mb4_bin'  # 指定区分大小写的排序规则
       )
       # 其他字段...
   

   然后执行迁移生效：

   python manage.py makemigrations
   python manage.py migrate
   

   之后用title__contains=search_query就能实现严格的大小写匹配了。

场景2：你确实需要「忽略大小写的搜索」但当前不生效

那大概率是数据库排序规则的问题，按下面步骤调整：

1. 先检查字段的排序规则，确保是不区分大小写的（比如utf8mb4_general_ci）；
2. 如果不是，修改模型字段的db_collation为不区分大小写的规则，然后执行迁移；
3. 也可以用临时方案，手动在查询时统一转换大小写：

   similar_titles_results = Product.objects.filter(
       title__lower__contains=search_query.lower(),
       parent_product__isnull=True,
       domain_name=domain_name,
       is_published=False
   ).order_by('?')[:5]
   

   不过这种方式不如直接修改数据库排序规则彻底。

快速测试技巧 #

你可以直接在MySQL里跑SQL验证，排除Django的影响：

-- 忽略大小写的查询
SELECT * FROM your_app_product WHERE title LIKE '%travel%' COLLATE utf8mb4_general_ci;
-- 严格区分大小写的查询
SELECT * FROM your_app_product WHERE title LIKE '%travel%' COLLATE utf8mb4_bin;

对比两个结果，就能快速确定问题出在数据库还是Django的代码里了。

备注：内容来源于stack exchange，提问作者boyenec