NoSQL 与搜索 / 系统课时

搜索需求与指标设计

搜索需求与指标设计

本课把“商品能搜到”转化为可开发、可验收的搜索方案。你将梳理关键词、筛选、排序、补全与统计五类需求,并为相关性、延迟和可用性建立可量化指标,最终形成一份能直接指导索引与接口设计的搜索契约。

学习目标

  • 将用户搜索场景拆成明确的查询能力与边界条件
  • 为搜索质量、响应速度和稳定性定义可验收指标
  • 建立需求、接口、数据和监控之间的对应关系

从用户任务拆出搜索能力

商品搜索的起点不是 Elasticsearch 查询语法,而是用户要完成什么任务。典型任务包括“按名称找商品”“在结果中缩小范围”“优先看到更值得购买的商品”和“输入一半就获得建议”。每个任务都应转成独立能力,避免把所有逻辑塞进一个关键词参数。

用户任务 搜索能力 关键输入 主要输出
找到相关商品 关键词搜索 关键词、搜索范围 命中文档、相关性分数
缩小结果范围 条件筛选 品牌、类目、价格、库存 过滤后的结果集
调整展示顺序 业务排序 销量、价格、上架时间 稳定且可解释的顺序
快速完成输入 搜索补全 前缀、热门度 候选词或候选商品
展示分类统计 聚合统计 当前查询条件 品牌、类目、价格区间计数

筛选条件通常不参与相关性评分;排序字段必须有稳定的兜底规则;补全接口要与正式搜索使用一致的商品状态和权限条件。这样才能避免“补全看得到,但点进去搜不到”的体验断层。

商品搜索需求到指标的关系图

建立可执行的查询契约

需求需要落到固定的请求结构中,才能约束前端、后端和搜索层。下面是片段示例,用于说明查询契约;它不是可独立执行的接口请求,实际项目还需补充鉴权、分页上限和错误码。

json
{
  "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 资源占用。

验收必须记录测试数据版本、索引版本、查询集版本和环境规格。缺少这些信息,即使指标达标,也无法在下一次调整分析器或排序规则后复现结果。

本课总结

  • 搜索需求应拆成关键词、筛选、排序、补全和统计五类能力
  • 质量、延迟与可用性必须使用可重复计算的指标验收
  • 查询契约和验收数据版本是后续索引设计与迭代的共同基线

下一课预告

下一课将把这些需求落实到商品索引,设计中文分析器、多字段映射以及用于筛选和业务排序的字段。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

搜索需求与指标设计

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通