NoSQL 与搜索 / 系统课时
补全与筛选导航实现
补全与筛选导航实现
本课实现搜索框补全和结果页筛选导航:输入前缀即可获得候选词,同时返回品牌、分类、价格区间及已选条件。重点是让补全响应足够快,并保证用户勾选筛选项后仍能看到有意义的聚合计数。
学习目标
- 使用
search_as_you_type实现前缀补全 - 用聚合生成品牌、分类和价格筛选项
- 处理已选条件回显及筛选后的计数口径
数据建模与能力拆分
补全和筛选导航应分成两个接口。补全接口只返回少量候选词,避免携带聚合;搜索接口在返回商品时同时计算品牌、分类和价格分桶。二者可以共用同一个商品索引,但使用不同字段和查询结构。

索引中用于补全的字段可以定义为 search_as_you_type,品牌和分类标识应使用 keyword 或数值类型,价格使用数值类型。
{
"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 及其自动生成的二元、三元分词字段。只返回名称并按名称折叠,避免重复候选。
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"
}
}'预期结果
HTTP 200
{
"hits": {
"hits": [
{
"_source": {
"name": "<SUGGESTION>"
}
}
]
}
}hits.hits 最多返回 10 条候选,每条包含 _source.name;相同 name.keyword 的候选只保留一条,实际候选内容取决于索引数据。
若要使用 collapse,必须额外存在 name.keyword 字段;没有该字段时可由后端去重。补全接口应设置较短超时,并在前端输入停止 150~300 毫秒后再发送请求。
实现筛选导航聚合
搜索结果页可在同一次请求中返回品牌、分类、价格区间和价格统计。下面示例使用关键词作为主查询,并通过 post_filter 应用当前已选品牌,使聚合仍展示全量候选品牌;其他筛选条件也可按同一思路处理。
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"
}
}
}
}'预期结果
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适合筛选导航- 已选条件由后端回显,聚合计数需明确是否排除当前筛选项
下一课预告
下一课将把搜索接口、补全接口和筛选导航整合进前端交互流程,并补充缓存、超时与性能监控策略。