如何用Elasticsearch7.7的RestHighLevelClient实现多字段匹配BoolQuery

针对你的需求，在Elasticsearch 7.7的RestHighLevelClient中，有两种直接的实现方式：

一、使用BoolQuery的Should子句 #

通过BoolQuery的should子句包含三个字段的Match查询，并设置minimum_should_match: 1，确保只要任意一个字段匹配搜索值就返回结果。

Java代码示例 #

import org.elasticsearch.action.search.SearchRequest;
import org.elasticsearch.action.search.SearchResponse;
import org.elasticsearch.client.RequestOptions;
import org.elasticsearch.client.RestHighLevelClient;
import org.elasticsearch.index.query.BoolQueryBuilder;
import org.elasticsearch.index.query.MatchQueryBuilder;
import org.elasticsearch.index.query.QueryBuilders;
import org.elasticsearch.search.builder.SearchSourceBuilder;

import java.io.IOException;

public class SearchExample {
    public void searchMultiFields(RestHighLevelClient client, String searchValue) throws IOException {
        // 构建三个字段的Match查询
        MatchQueryBuilder nameMatch = QueryBuilders.matchQuery("name", searchValue);
        MatchQueryBuilder cityMatch = QueryBuilders.matchQuery("city", searchValue);
        MatchQueryBuilder stateMatch = QueryBuilders.matchQuery("state", searchValue);

        // 构建BoolQuery，使用should子句，设置至少匹配1个
        BoolQueryBuilder boolQuery = QueryBuilders.boolQuery()
                .should(nameMatch)
                .should(cityMatch)
                .should(stateMatch)
                .minimumShouldMatch(1);

        // 构建搜索请求
        SearchSourceBuilder sourceBuilder = new SearchSourceBuilder().query(boolQuery);
        SearchRequest searchRequest = new SearchRequest("你的索引名").source(sourceBuilder);

        // 执行搜索
        SearchResponse response = client.search(searchRequest, RequestOptions.DEFAULT);
        // 处理响应结果...
    }
}

二、使用Multi-Match查询 #

Multi-Match是Elasticsearch专门为多字段匹配设计的查询，语法更简洁，本质上和BoolQuery的should逻辑一致，但代码更紧凑。

Java代码示例 #

import org.elasticsearch.action.search.SearchRequest;
import org.elasticsearch.action.search.SearchResponse;
import org.elasticsearch.client.RequestOptions;
import org.elasticsearch.client.RestHighLevelClient;
import org.elasticsearch.index.query.MultiMatchQueryBuilder;
import org.elasticsearch.index.query.QueryBuilders;
import org.elasticsearch.search.builder.SearchSourceBuilder;

import java.io.IOException;

public class SearchExample {
    public void searchWithMultiMatch(RestHighLevelClient client, String searchValue) throws IOException {
        // 构建Multi-Match查询，指定要匹配的三个字段
        MultiMatchQueryBuilder multiMatchQuery = QueryBuilders.multiMatchQuery(searchValue, "name", "city", "state")
                .type(MultiMatchQueryBuilder.Type.BEST_FIELDS); // 默认就是BEST_FIELDS，可省略

        // 构建搜索请求
        SearchSourceBuilder sourceBuilder = new SearchSourceBuilder().query(multiMatchQuery);
        SearchRequest searchRequest = new SearchRequest("你的索引名").source(sourceBuilder);

        // 执行搜索
        SearchResponse response = client.search(searchRequest, RequestOptions.DEFAULT);
        // 处理响应结果...
    }
}

两种方式的说明 #

• BoolQuery的方式更灵活，如果后续需要给不同字段设置不同的匹配权重（比如name字段匹配的权重更高），可以给每个MatchQuery添加boost参数（如nameMatch.boost(2.0f)）。
• Multi-Match查询更简洁，适合这种简单的多字段任意匹配场景，默认会自动处理匹配逻辑，无需手动设置minimum_should_match。

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