You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在Django中实现对西里尔字母的不区分大小写搜索

解决Django SearchFilter对西里尔字母不生效的问题

你的问题核心是数据库排序规则不支持西里尔字母的大小写不敏感匹配,或者Django默认的icontains查询对非拉丁字母的处理不符合预期。下面给两种直接可行的解决办法:

方法一:自定义搜索过滤器,手动处理大小写转换

绕过数据库默认的大小写匹配逻辑,手动把搜索词和数据库字段统一转成小写后再匹配:

  1. 在你的app下新建filters.py文件,写入自定义过滤器:
from django_filters.rest_framework import SearchFilter
from django.db.models import Func, Q

class CyrillicSearchFilter(SearchFilter):
    def filter_queryset(self, request, queryset, view):
        search_term = request.query_params.get(self.search_param, '')
        if not search_term:
            return queryset
        
        # 将搜索词转为小写(支持西里尔字母)
        lower_search = search_term.lower()
        # 为每个搜索字段构建小写匹配条件
        conditions = []
        for field in view.search_fields:
            conditions.append(Func(field, function='LOWER')__contains=lower_search)
        
        # 用OR连接所有字段的匹配条件
        return queryset.filter(Q(*conditions))
  1. 修改views.py,替换默认的SearchFilter:
from .filters import CyrillicSearchFilter  # 导入自定义过滤器

class QuestionsAPIView(generics.ListCreateAPIView):
    search_fields = ['name_tm', 'name_ru', 'name_en']
    filter_backends = (CyrillicSearchFilter,)  # 替换成自定义过滤器
    queryset = Product.objects.all()
    serializer_class = ProductSerializer

方法二:修改数据库字段的排序规则

如果用的是MySQL,默认的utf8mb4_unicode_ci或utf8mb4_general_ci排序规则支持西里尔字母的大小写不敏感,但如果字段用了utf8mb4_bin这类区分大小写的规则,就会失效。

临时修改已有字段:

执行SQL语句调整name_ru字段的排序规则:

ALTER TABLE product MODIFY name_ru VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

(把product换成你的实际表名)

永久在模型中设置:

在models.py里给字段指定支持西里尔字母的排序规则:

class Product(models.Model):
    name_ru = models.CharField(
        max_length=255,
        db_collation='utf8mb4_unicode_ci'
    )
    name_tm = models.CharField(max_length=255, db_collation='utf8mb4_unicode_ci')
    name_en = models.CharField(max_length=255, db_collation='utf8mb4_unicode_ci')
    # 其他字段...

修改后执行迁移生效:

python manage.py makemigrations
python manage.py migrate

如果是PostgreSQL,需要先安装unaccent扩展,再给字段设置俄语专属排序规则(比如ru_RU.utf8),具体可根据PostgreSQL文档调整。

内容的提问来源于stack exchange,提问作者rowsen

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.07.25 18:42:24