NoSQL 与搜索 / 系统课时
搜索需求与指标设计
搜索需求与指标设计
本课把“商品能搜到”转化为可开发、可验收的搜索方案。你将梳理关键词、筛选、排序、补全与统计五类需求,并为相关性、延迟和可用性建立可量化指标,最终形成一份能直接指导索引与接口设计的搜索契约。
学习目标
- 将用户搜索场景拆成明确的查询能力与边界条件
- 为搜索质量、响应速度和稳定性定义可验收指标
- 建立需求、接口、数据和监控之间的对应关系
从用户任务拆出搜索能力
商品搜索的起点不是 Elasticsearch 查询语法,而是用户要完成什么任务。典型任务包括“按名称找商品”“在结果中缩小范围”“优先看到更值得购买的商品”和“输入一半就获得建议”。每个任务都应转成独立能力,避免把所有逻辑塞进一个关键词参数。
| 用户任务 | 搜索能力 | 关键输入 | 主要输出 |
|---|---|---|---|
| 找到相关商品 | 关键词搜索 | 关键词、搜索范围 | 命中文档、相关性分数 |
| 缩小结果范围 | 条件筛选 | 品牌、类目、价格、库存 | 过滤后的结果集 |
| 调整展示顺序 | 业务排序 | 销量、价格、上架时间 | 稳定且可解释的顺序 |
| 快速完成输入 | 搜索补全 | 前缀、热门度 | 候选词或候选商品 |
| 展示分类统计 | 聚合统计 | 当前查询条件 | 品牌、类目、价格区间计数 |
筛选条件通常不参与相关性评分;排序字段必须有稳定的兜底规则;补全接口要与正式搜索使用一致的商品状态和权限条件。这样才能避免“补全看得到,但点进去搜不到”的体验断层。

建立可执行的查询契约
需求需要落到固定的请求结构中,才能约束前端、后端和搜索层。下面是片段示例,用于说明查询契约;它不是可独立执行的接口请求,实际项目还需补充鉴权、分页上限和错误码。
{
"keyword": "蓝牙耳机",
"filters": {
"categoryId": "audio",
"brandIds": ["brand-a", "brand-b"],
"price": {
"gte": 10000,
"lte": 50000
},
"inStock": true
},
"sort": [
{
"field": "_score",
"order": "desc"
},
{
"field": "sales",
"order": "desc"
},
{
"field": "productId",
"order": "asc"
}
],
"page": 1,
"pageSize": 20
}价格使用最小货币单位可避免浮点误差;排序最后加入唯一字段 productId,可保证同分文档顺序稳定。验证契约时,应分别测试空关键词、无筛选、多筛选组合、非法排序字段和超大分页参数。
定义搜索质量指标
搜索质量不能只看“有没有结果”。离线评估可准备一组“查询词—理想商品”标注集,计算 Top K 命中率、准确率或 NDCG;线上则观察无结果率、搜索后点击率、加购率和查询改写率。离线指标适合比较算法版本,线上指标用于判断真实业务收益。
建议先确定一组可落地的基线:核心查询 Top 10 命中率达到约定目标;无结果率保持在业务阈值内;高频查询的点击率不低于旧版本。具体数值应来自历史数据和业务目标,而不是照搬其他系统。
定义性能与可用性指标
延迟应按百分位统计,而不是只看平均值。常用指标包括 P50、P95 和 P99,其中 P95 更适合作为接口验收标准。统计时要区分搜索服务总耗时、Elasticsearch 查询耗时和网络耗时,否则出现慢请求时无法定位瓶颈。
可用性至少包含成功率、超时率、拒绝率和集群健康状态。接口成功率应排除明确的客户端参数错误,再计算服务端可用性;同时为补全、正式搜索和聚合分别监控,因为它们的查询复杂度与流量特征不同。
形成验收清单
上线前应使用真实商品数据和代表性查询词执行验收。功能验收覆盖关键词、筛选组合、排序稳定性、补全一致性和聚合计数;质量验收比较新旧版本的标注集得分;性能验收在目标并发下观察 P95 延迟、错误率和 Elasticsearch 资源占用。
验收必须记录测试数据版本、索引版本、查询集版本和环境规格。缺少这些信息,即使指标达标,也无法在下一次调整分析器或排序规则后复现结果。
本课总结
- 搜索需求应拆成关键词、筛选、排序、补全和统计五类能力
- 质量、延迟与可用性必须使用可重复计算的指标验收
- 查询契约和验收数据版本是后续索引设计与迭代的共同基线
下一课预告
下一课将把这些需求落实到商品索引,设计中文分析器、多字段映射以及用于筛选和业务排序的字段。