第 5 章 命中之路：一次查询的完整旅程

第 5 章 · 命中之路：一次查询的完整旅程

章节摘要：一次搜索从协调节点扇出到所有相关分片，各自查倒排表、算相关性分，再归并成全局排序——这是命中之路的主干。本章先解剖搜索请求的结构与两阶段执行，再把 Query DSL 从 match 一路讲到 bool 组合与 filter 上下文，最后整理命中结果：排序、分页、高亮与建议。读完你能解释"为什么这条排第一、分数 3.7 从哪来、深分页为什么慢"。

学习目标

阅读完本章，你应当能够：

1. 画出一次搜索的两阶段执行图，说出 query then fetch 各阶段分片与协调节点的分工。
2. 区分查询上下文与过滤上下文，解释 filter 不算分且结果可缓存的原因。
3. 用 match、match_phrase、term、range、bool 组合出业务级的检索逻辑。
4. 解读相关性得分的构成，用命名查询拆出每个子句的贡献。
5. 按需求选择排序键与分页方式，说明 from 加 size 深翻页的代价与替代方案。
6. 配置高亮与拼写建议，把命中结果整理成可直接上线的形态。

核心概念速览

金句：查询上下文问"多匹配"，过滤上下文问"匹不匹配"——前者算分，后者缓存，混用是性能与语义的双重浪费。

子章节导航

5.1 搜索请求解剖：Search API 的结构

一次搜索请求的骨架：从路由到分片、两阶段执行、响应各字段含义、常见参数（尺寸、源过滤、超时）。地基打牢，后面的 DSL 才有处安放。

5.2 Query DSL 实战：从 match 到 bool

全文检索的主力家族与精确过滤的利器同场：match 的分词语义、短语匹配、term 的暗坑、range 的边界、bool 四种子句的分工，以及 filter 上下文的缓存红利。

5.3 结果整理：排序、分页、高亮与建议

命中之后的整理台：单字段与脚本排序、from 加 size 的深翻页陷阱、搜索后高亮的取舍、拼写建议器。产品经理眼里"搜索好不好用"，一半取决于这一节。

子章节之间的逻辑关系

三节是"骨架、灵魂、妆容"的关系：5.1 定请求的形，5.2 填查询的魂，5.3 修结果的形。5.2 的打分直觉依赖 3.2 的分词暗号——写入切出的词条决定 match 能命中什么；5.3 的排序依赖 3.1 的 keyword 子字段——文本排序必须落在整串形态上。命中之路处处回响着分词台的余音。

5.1 请求骨架与两阶段 ──► 5.2 DSL与打分 ──► 5.3 排序分页高亮
       │                     │                   │
       └─► 第6章 聚合同样走   └─► 第3章 分词暗号   └─► 第9章 搜索体验优化
           两阶段执行
​

本章考核清单

易错点速查

• 只看 took 不看 timed_out：超时返回的是部分结果，数字变小可能是"没查完"而不是"变快了"。
• 深翻页硬调大窗口：from 加 size 的代价藏在第一阶段的候选爆炸，护栏被拆就是内存事故。
• 对 text 字段直接排序：排序需要整串形态，text 要走 keyword 子字段，直接排会报错或结果错乱。

前置知识与后续延伸

• 前置知识：第 3 章分词与分析器（match 的行为完全由它决定）；第 1 章倒排表里的词频与位置（打分的原材料）。
• 后续延伸：两阶段执行模型在 8.1 的深分页治理与 9.3 的慢查询诊断里反复出现；filter 上下文是第 9 章查询优化的第一刀；建议器思路延伸到第 9 章的搜索体验设计。