ElasticSearch Python查询中高亮结果不显示问题排查求助

问题现象 #

执行指定查询语句无语法错误，但返回结果中缺少highlight字段，预期的title字段高亮内容未展示。

查询语句 #

search_query = {
    'query': {
        'multi_match': {
            'query': query,
            'fields': ['title', 'text']
        }
    },
    'highlight': {
        'pre_tags': ['<b>', '<em>'],
        'post_tags': ['</b>', '</em>'],
        'fields': {
            'title': {}
        }
    }
}

示例文档 #

doc = {
    'title': 'The website title',
    'image': 'https://thedomain.com/images/sample_image.jpg',
    'text': 'blah blah blah .. etc.'
}

搜索关键词：website

索引映射与创建代码 #

索引映射 #

request_body = {
    "settings": {
        "number_of_shards": 1,
        "number_of_replicas": 1
    },
    "mappings": {
        "properties": {
            "title": {
                "type": "text",
                "index": 'true'
            }
        }
    }
}

索引创建代码 #

es = Elasticsearch([{'host': 'localhost', 'scheme': 'http', 'port': 9200}])
es.indices.create(index=index_name, body=request_body)

排查要点 #

• 确认查询调用方式：检查是否将search_query正确传入es.search()的body参数，而非误用q参数（q参数会忽略高亮配置）。正确调用示例：

  es.search(index=index_name, body=search_query)
  

• 验证文档匹配情况：先执行简单match查询确认目标文档能被检索到，排除因无匹配文档导致高亮不生成的情况：

  test_query = {
      'query': {
          'match': {'title': 'website'}
      }
  }
  es.search(index=index_name, body=test_query)
  

• 修正高亮标签格式：当前pre_tags和post_tags使用了HTML实体转义（<b>），在Python字典中直接使用原生标签即可，转义后会被ES识别为普通文本，虽不影响highlight字段生成，但会导致高亮标签失效：

  'highlight': {
      'pre_tags': ['<b>', '<em>'],
      'post_tags': ['</b>', '</em>'],
      'fields': {'title': {}}
  }
  

• 检查字段映射完整性：查询中包含text字段，但索引映射未定义该字段，ES会自动生成默认映射（text类型），需确认该字段未被意外设置为index: false，避免影响查询匹配。
• 确认索引正确性：确保查询时指定的索引名称与创建时的index_name一致，避免查错索引导致无匹配结果。

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