Django3.x搭配MySQL使用icontains仍返回大小写敏感结果排查

• 字段级校对规则优先级高于表级：仅修改表的校对规则不会覆盖字段单独配置的校对规则，若translation字段单独设置了_bin后缀的大小写敏感校对，表级配置不生效。
• 数据库会话级校对规则不匹配：Django与MySQL建立连接时使用的会话校对规则为大小写敏感类型，优先级高于库、表、字段级配置。
• Django ORM生成查询时强制二进制匹配：部分特殊场景下ORM会为查询字段自动加BINARY关键字，导致LIKE查询变为大小写敏感。
• filter逻辑被覆盖：存在自定义filter_queryset逻辑或其他过滤后端，覆盖了django-filter中配置的icontains查询规则。

• 首先打印实际执行的SQL确认查询规则：在settings.py中配置SQL日志输出，查看translation字段的查询语句是否带有BINARY关键字，是否符合LIKE '%One%'的预期格式。
  日志配置参考：

  LOGGING = {
      'version': 1,
      'disable_existing_loggers': False,
      'handlers': {'console': {'class': 'logging.StreamHandler'}},
      'loggers': {'django.db.backends': {'handlers': ['console'], 'level': 'DEBUG'}},
  }
  

• 检查字段级校对规则：在MySQL中执行语句SHOW FULL COLUMNS FROM 你的dictionary表名;，查看translation字段的Collation列是否为_ci后缀的大小写不敏感规则（如utf8mb4_unicode_ci）。
• 验证会话级校对配置：进入Django Shell执行以下代码，确认连接使用的校对规则为大小写不敏感类型：

  from django.db import connection
  with connection.cursor() as cursor:
      cursor.execute("SELECT @@collation_connection;")
      print(cursor.fetchone())
  

• 直接在MySQL中执行原生SQL验证：执行SELECT * FROM dictionary WHERE translation LIKE '%One%';，如果返回结果仍不包含小写one的内容，说明问题出在数据库层面，与Django无关。

• 若为字段校对规则问题：可以直接在MySQL中修改字段校对，也可以在Django模型字段中添加collation参数（Django 3.2+支持）后生成迁移执行：

  -- MySQL直接修改
  ALTER TABLE 表名 MODIFY COLUMN translation VARCHAR(字段长度) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  

  # 模型层配置示例
  translation = models.CharField(max_length=255, collation='utf8mb4_unicode_ci')
  

• 若为会话级校对问题：在settings.py的数据库配置中添加初始化命令强制指定连接校对：

  DATABASES = {
      'default': {
          'ENGINE': 'django.db.backends.mysql',
          # 其他配置省略
          'OPTIONS': {
              'init_command': "SET collation_connection = 'utf8mb4_unicode_ci'",
          }
      }
  }
  

• 若为ORM生成二进制查询问题：可以自定义过滤方法，强制将字段和查询值统一转小写后匹配，彻底规避校对规则影响：

  from django.db.models import Value
  from django.db.models.functions import Lower
  
  class FuzzyFilter(filters.FilterSet):
      # 其他filter省略
      translation = filters.CharFilter(method='filter_translation_ci')
      
      def filter_translation_ci(self, queryset, name, value):
          return queryset.annotate(
              lower_trans=Lower(name)
          ).filter(
              lower_trans__contains=Value(value.lower())
          )
  

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