NoSQL 与搜索 / 系统课时

补全与筛选导航实现

补全与筛选导航实现

本课实现搜索框补全和结果页筛选导航:输入前缀即可获得候选词,同时返回品牌、分类、价格区间及已选条件。重点是让补全响应足够快,并保证用户勾选筛选项后仍能看到有意义的聚合计数。

学习目标

  • 使用 search_as_you_type 实现前缀补全
  • 用聚合生成品牌、分类和价格筛选项
  • 处理已选条件回显及筛选后的计数口径

数据建模与能力拆分

补全和筛选导航应分成两个接口。补全接口只返回少量候选词,避免携带聚合;搜索接口在返回商品时同时计算品牌、分类和价格分桶。二者可以共用同一个商品索引,但使用不同字段和查询结构。

补全与筛选导航数据流

索引中用于补全的字段可以定义为 search_as_you_type,品牌和分类标识应使用 keyword 或数值类型,价格使用数值类型。

json
{
  "mappings": {
    "properties": {
      "name": {
        "type": "text",
        "fields": {
          "keyword": {
            "type": "keyword",
            "ignore_above": 256
          }
        }
      },
      "nameSuggest": {
        "type": "search_as_you_type",
        "max_shingle_size": 3
      },
      "brandId": { "type": "keyword" },
      "brandName": { "type": "keyword" },
      "categoryId": { "type": "keyword" },
      "categoryName": { "type": "keyword" },
      "price": { "type": "scaled_float", "scaling_factor": 100 }
    }
  }
}

生效行为:写入商品时应让 nameSuggest 与 name 保存相同文本,Elasticsearch 会为补全字段自动生成适合前缀匹配的子字段。可通过映射查询确认字段类型,已有索引则需要新建索引并重建数据,不能直接修改原字段类型。

实现搜索词补全

补全接口可以接收 prefix,将 <PORT> 替换为实际 Elasticsearch 端口,并使用 bool_prefix 查询 nameSuggest 及其自动生成的二元、三元分词字段。只返回名称并按名称折叠,避免重复候选。

bash
curl -X POST "http://localhost:<PORT>/products/_search"   -H "Content-Type: application/json"   -d '{
    "size": 10,
    "_source": ["name"],
    "query": {
      "multi_match": {
        "query": "无线耳",
        "type": "bool_prefix",
        "fields": [
          "nameSuggest",
          "nameSuggest._2gram",
          "nameSuggest._3gram"
        ]
      }
    },
    "collapse": {
      "field": "name.keyword"
    }
  }'

预期结果

text
HTTP 200
{
  "hits": {
    "hits": [
      {
        "_source": {
          "name": "<SUGGESTION>"
        }
      }
    ]
  }
}

hits.hits 最多返回 10 条候选,每条包含 _source.name;相同 name.keyword 的候选只保留一条,实际候选内容取决于索引数据。

若要使用 collapse,必须额外存在 name.keyword 字段;没有该字段时可由后端去重。补全接口应设置较短超时,并在前端输入停止 150~300 毫秒后再发送请求。

实现筛选导航聚合

搜索结果页可在同一次请求中返回品牌、分类、价格区间和价格统计。下面示例使用关键词作为主查询,并通过 post_filter 应用当前已选品牌,使聚合仍展示全量候选品牌;其他筛选条件也可按同一思路处理。

bash
curl -X POST "http://localhost:<PORT>/products/_search"   -H "Content-Type: application/json"   -d '{
    "size": 20,
    "query": {
      "multi_match": {
        "query": "无线耳机",
        "fields": ["name^3", "subtitle^2", "brandName"]
      }
    },
    "post_filter": {
      "term": {
        "brandId": "brand-001"
      }
    },
    "aggs": {
      "brands": {
        "terms": {
          "field": "brandId",
          "size": 20
        },
        "aggs": {
          "brand_name": {
            "top_hits": {
              "size": 1,
              "_source": ["brandName"]
            }
          }
        }
      },
      "categories": {
        "terms": {
          "field": "categoryId",
          "size": 20
        }
      },
      "price_ranges": {
        "range": {
          "field": "price",
          "ranges": [
            { "key": "0-100", "to": 100 },
            { "key": "100-300", "from": 100, "to": 300 },
            { "key": "300+", "from": 300 }
          ]
        }
      },
      "price_stats": {
        "stats": {
          "field": "price"
        }
      }
    }
  }'

预期结果

text
HTTP 200
{
  "hits": {
    "hits": [
      {
        "_source": {
          "brandId": "brand-001"
        }
      }
    ]
  },
  "aggregations": {
    "brands": { "buckets": ["<BRAND_BUCKETS>"] },
    "categories": { "buckets": ["<CATEGORY_BUCKETS>"] },
    "price_ranges": { "buckets": ["<PRICE_RANGE_BUCKETS>"] },
    "price_stats": {
      "count": <COUNT>,
      "min": <MIN>,
      "max": <MAX>,
      "avg": <AVG>,
      "sum": <SUM>
    }
  }
}

命中结果只包含 brandId = brand-001 的商品;聚合分别返回品牌、分类、三个价格区间及价格统计。占位值会随索引数据变化。

post_filter 只过滤命中结果,不影响聚合,因此适合保留品牌全量计数。若品牌、分类和价格可以同时多选,并且每组都要排除自身条件后重新计数,应为每个聚合增加独立的 filter 聚合;不要简单把所有已选条件都放进主查询,否则可选项会过早消失。

回显筛选条件与接口验收

Elasticsearch 不负责保存用户选择。后端应把规范化后的请求条件原样放入响应,例如 selectedFilters 中包含品牌、分类、价格上下限和库存状态。前端据此恢复勾选状态,而不是从聚合结果猜测用户选择。

验收时分别检查空关键词、输入一个字符、重复名称、品牌单选、品牌与分类组合、无结果条件和价格边界。补全结果应稳定去重;筛选结果中的商品必须符合已选条件;聚合计数必须符合约定的统计口径。

本课总结

  • 补全接口和筛选聚合接口应拆分,分别优化响应速度和统计能力
  • search_as_you_type 适合前缀补全,terms、range 与 stats 适合筛选导航
  • 已选条件由后端回显,聚合计数需明确是否排除当前筛选项

下一课预告

下一课将把搜索接口、补全接口和筛选导航整合进前端交互流程,并补充缓存、超时与性能监控策略。

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

目录与阅读设置

阅读设置

17

记录一个想法

补全与筛选导航实现

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

登录哪都通