在 Elasticsearch 8.x Java 客户端中，matchQuery 不支持直接传入多个查询值；需使用 bool 查询配合多个 should 子句，实现对同一字段（如 fileType）的多值“或”匹配。

在 elasticsearch 8.x java 客户端中，`matchquery` 不支持直接传入多个查询值；需使用 `bool` 查询配合多个 `should` 子句，实现对同一字段（如 `filetype`）的多值“或”匹配。

要查询 fileType 字段值为 "EXP" 或 "WAIT_EXP" 的文档，不能写成：

// ❌ 错误：matchQuery 只接受单个字符串值，以下语法不合法
MatchQuery.of(m -> m.field("fileType").query("EXP", "WAIT_EXP"))

正确做法是构建一个 BoolQuery，将多个 match 条件通过 .should() 添加——这等价于逻辑“OR”（注意：需确保 minimumShouldMatch(1)，默认即满足）：

import co.elastic.clients.elasticsearch.ElasticsearchClient;
import co.elastic.clients.elasticsearch._types.query_dsl.*;
import co.elastic.clients.elasticsearch.core.SearchRequest;
import co.elastic.clients.elasticsearch.core.SearchResponse;

// 构建布尔查询：fileType 为 EXP 或 WAIT_EXP
Query query = Query.of(q -> q
    .bool(b -> b
        .should(s -> s.match(m -> m.field("fileType").query("EXP")))
        .should(s -> s.match(m -> m.field("fileType").query("WAIT_EXP")))
        .minimumShouldMatch("1") // 显式声明至少匹配一个（可选，默认即为1）
    )
);

SearchRequest request = SearchRequest.of(r -> r
    .index("your_documents_index")
    .query(query)
);

SearchResponse<Document> response = client.search(request, Document.class);

✅ 关键说明：

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

• should 子句在无 must 或 filter 时默认以“或”方式生效；若同时存在 must，则 should 仅影响相关性评分（除非设置 minimumShouldMatch）。
• 若字段是精确匹配场景（如枚举值），更推荐使用 termsQuery（底层对应 terms 查询，性能更优、语义更准确）：

Query termsQuery = Query.of(q -> q
    .terms(t -> t
        .field("fileType")
        .terms(tt -> tt.value(
            List.of("EXP", "WAIT_EXP")
                .stream()
                .map(JsonData::of)
                .toList()
        ))
    )
);

⚠️ 注意事项：

立即学习“Java免费学习笔记（深入）”；

• 确保 fileType 字段在映射中未被分词（如设为 keyword 类型），否则 match 查询可能因分析器拆分而失效；若已分词，应改用 multi_match 或调整分析策略。
• 使用 termsQuery 时，值必须与倒排索引中的原始词条完全一致（大小写、下划线等敏感）。

综上，多值字段匹配应优先选用 bool + should 或更精准的 terms 查询，而非强行扩展 matchQuery——这是 Elasticsearch Java API 8.x 的标准实践。