DRF集成django_elasticsearch_dsl时多字段搜索失效：仅能通过title字段检索，description字段无匹配结果

看起来你遇到的问题是ElasticSearch只在title字段命中关键词，而忽略了description字段的匹配。结合你的代码和场景，我整理了几个最可能的解决方向，一步步排查：

1. 先重建ElasticSearch索引（最关键的第一步） #

很多时候字段搜索失效是因为索引数据和最新的Document配置不匹配——比如你修改了分析器（analyzer）后，旧的索引数据还是用旧规则处理的，自然搜不到新的关键词。

运行以下命令彻底重建索引：

# 删除旧索引
python manage.py search_index --delete
# 创建新索引（应用最新的ProductDocument配置）
python manage.py search_index --create
# 将Django数据库中的Product数据重新同步到ES索引
python manage.py search_index --populate

这一步做完后，先试试搜Книга，很大概率能解决问题。

2. 验证ES对description字段的分词是否正确 #

如果重建索引后还是搜不到，我们先排除分析器的问题：用ES的Analyze API测试你的multilang_analyzer对Книга的处理逻辑：

curl -X GET "http://elasticsearch:9200/products/_analyze?pretty" -H 'Content-Type: application/json' -d'
{
  "analyzer": "multilang_analyzer",
  "text": "Книга"
}
'

正常情况下，返回的tokens应该是книг（俄语词干提取后的结果）。如果结果为空或者得到的token不是你预期的，说明分析器配置有问题：

• 检查russian_stop过滤器：Книга不是俄语停用词，不应该被过滤掉；
• 确认russian_stemmer正常工作：俄语的Книга词干化后是книг。

3. 直接在ES中测试查询，排除DRF视图的影响 #

有时候问题出在DRF视图对ES响应的处理上，我们先绕开DRF，直接用ES查询验证：

curl -X GET "http://elasticsearch:9200/products/_search?pretty" -H 'Content-Type: application/json' -d'
{
  "query": {
    "multi_match": {
      "query": "Книга",
      "fields": ["title^2", "description"]
    }
  }
}
'

如果这个查询能返回目标文档，但DRF视图返回空，那就是视图的问题。你当前的视图直接返回search.execute()的响应，而DRF的ListAPIView期望的是Django模型实例的可迭代对象（比如QuerySet）。修改视图的get_queryset方法：

def get_queryset(self):
    q = self.request.GET.get("query", "")
    if q:
        search = ProductDocument.search().query(
            'multi-match', query=q, fields=["title^2", "description"]
        )
        # 用to_queryset()把ES结果转换为Django模型实例的QuerySet
        return search.to_queryset()
    # 无查询词时返回正常的Product QuerySet（可根据需求添加过滤，比如排除已删除商品）
    return Product.objects.all()

search.to_queryset()会自动从数据库拉取匹配的模型实例，更符合DRF的序列化预期。

4. 检查ProductDocument的字段定义是否冲突 #

你在ProductDocument中显式定义了title和description字段，同时在Django子类中又指定了fields=['title', 'description']。虽然这本身不会冲突，但要确保显式定义的字段配置完全覆盖自动映射：

@registry.register_document
class ProductDocument(Document):
    title = fields.TextField(analyzer="multilang_analyzer")
    description = fields.TextField(analyzer="multilang_analyzer")

    class Index:
        name = "products"
        settings = {
            # ... 你的分析器配置 ...
        }

    class Django:
        model = Product
        # 这里的fields可以去掉，因为已经显式定义了title和description
        # fields = ['title', 'description']

去掉Django子类中的fields配置，避免自动映射和显式定义的潜在冲突。

最后验证 #

完成上面的步骤后，再测试搜索Книга，应该就能命中目标文档了。如果还是有问题，可以把ES的Analyze结果和查询结果贴出来，我们再进一步排查。

内容来源于stack exchange