通义灵码全文检索实战：Elasticsearch查询语法详解

构建准确的Elasticsearch全文检索查询，前提是吃透字段映射类型、分词器工作机制、匹配逻辑以及DSL语法结构。这三项若未理清，即使DSL语法校验通过，检索结果依然为空——这种教训一次足矣。

具体而言，text字段搭配match查询，keyword字段必须使用term或重新映射为text；match默认采用OR逻辑，通过operator参数设为and或调整minimum_should_match可精确控制召回率；需要短语连续匹配时启用match_phrase；跨字段联合搜索则应使用multi_match，并对核心字段赋予更高权重。

字段类型验证：全文检索的基础门槛

首个操作永远是自检。执行GET /your_index/_mapping确认目标字段的type属性。仅当字段类型为text时，才会触发分词流程，才支持match查询。若字段是keyword，match将直接返回空结果——根本原因在于keyword不做分词，而match先对输入分词再查询倒排索引，导致匹配失败。

牢记：字段名无法反映真实类型，必须通过映射验证。

举例说明：文档中字段值为"name": "Apple iPhone 15 Pro Max"，若name映射为keyword，执行{"match": {"name": "iPhone 15"}}必然无结果。解决方案是改用term查询，或重新映射该字段为text类型。

核心查询：match 全文匹配

最基础用法：对单个字段进行宽松匹配。发起GET /products/_search，请求体如下：

{"query": {"match": {"title": "ja va spring boot"}}

Elasticsearch会将输入按默认分词器拆解为["ja va", "spring", "boot"]，采用OR逻辑合并结果——只要文档含有任一词条即被召回。

若需缩小范围、消除噪音，可在match中明确设置"operator": "and"：

{"query": {"match": {"title": {"query": "ja va spring boot", "operator": "and"}}}}

此时仅返回同时包含三个词条的文档。注意：不要求词条连续出现，只要求字段中分别存在这三个词。

精确短语匹配：match_phrase 查询

何时使用match_phrase？当查询要求“iPhone 15”作为完整短语紧密相邻，排除“iPhone X 15”或“iPhone, 15 Pro”这类结果时，它是最佳选择。

请求构造：

GET /products/_search → 请求体：

{"query": {"match_phrase": {"name": "iPhone 15"}}

它不会将输入分词后分散匹配，而是查找分词后连续出现的词条序列。前提条件是name字段为text类型且使用标准分词器。

若不确定匹配结果，可提前执行GET /products/_analyze?field=name，传入{"text": "iPhone 15"}，观察实际产出的词条，再对比文档中该字段经相同分析器处理后的输出是否一致。

多字段联合搜索：multi_match 查询

推荐实践：通过fields数组列出所有待检索的text字段，并附加权重以区分优先级：

{"query": {"multi_match": {"query": "xiaomi nfc", "fields": ["name^3", "desc^1", "tags^2"]}}

字段后的^3表示该字段匹配得分乘以3，使标题匹配比描述更具权重。不设置权重时默认等权。

若仅关心字段中是否出现关键词，不关注相关性排序，可简化写法：

{"query": {"multi_match": {"query": "xiaomi nfc", "fields": ["name", "desc"]}}

注意事项：切勿将keyword字段加入fields列表，因其不支持全文匹配，可能导致查询静默失败或返回结果极度稀疏。

召回粒度控制：minimum_should_match 参数

用户搜索“red black blue”时，结果中可能混入大量仅包含单个颜色的文档。默认OR逻辑过于宽松，需收紧条件。

在match中添加"minimum_should_match": "2"：

{"query": {"match": {"description": {"query": "red black blue", "minimum_should_match": "2"}}}}

表示至少匹配其中两个词条方为合格。数值支持整数（如2）、百分比（如"75%"）或混合语法（如"2<-1 75%"）。

边界值测试："100%"等同于"and"；"0%"则退化为"or"。生产环境建议从"2"开始调优，避免一次性设置过高。

来源：互联网