Elasticsearch 8.6：查询含字段精确值时如何提升文档权重

要实现「查询文本包含category字段精确值时提升文档权重」的需求，核心是判断文档的category值是否作为连续子串出现在查询文本中，同时避免普通match查询带来的部分匹配加权问题。可以通过function_score查询配合自定义脚本实现：

步骤1：确保category字段有精确匹配的子字段 #

如果你的category字段是text类型，需要先添加keyword子字段来获取精确的字符串值（避免分词干扰），修改mapping的DSL如下：

PUT /your_index/_mapping
{
  "properties": {
    "category": {
      "type": "text",
      "fields": {
        "keyword": {
          "type": "keyword",
          "ignore_above": 256
        }
      }
    }
  }
}

步骤2：编写带权重提升的查询DSL #

使用function_score，主查询保留正常的全文搜索逻辑，通过script_score函数判断条件并加权：

{
  "query": {
    "function_score": {
      "query": {
        // 主查询：正常的全文搜索，这里以title字段为例
        "match": {
          "title": {
            "query": "blue kids clothes"
          }
        }
      },
      "functions": [
        {
          "script_score": {
            "script": {
              "source": """
                // 获取文档的category精确值
                def category = doc['category.keyword'].value;
                // 统一转小写，避免大小写敏感问题
                def queryText = params.queryText.toLowerCase();
                
                // category为空则不处理
                if (category == null || category.isEmpty()) {
                  return 1.0;
                }
                
                def categoryLower = category.toLowerCase();
                // 检查查询文本是否包含category的精确子串，是则返回加权系数（比如2.0），否则返回1.0不影响得分
                return queryText.contains(categoryLower) ? 2.0 : 1.0;
              """,
              "params": {
                "queryText": "blue kids clothes" // 这里传入你的查询文本
              }
            }
          }
        }
      ],
      "boost_mode": "multiply" // 加权系数与主查询得分相乘，实现权重提升
    }
  }
}

逻辑说明 #

• 用category.keyword获取未分词的精确字段值，确保判断的是完整的category内容。
• 统一转小写处理，避免"Kids clothes"和"kids clothes"因大小写不匹配漏判。
• 仅当查询文本连续包含category的精确值时，才会将文档得分乘以指定系数（示例中是2.0，可根据需求调整）。
• category为空的文档（比如示例中的文档2）永远不会触发加权。

验证预期场景 #

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