【电商项目】商品搜索开发复盘(2):构造ES搜索条件逻辑实现与思考

发布时间:2026/10/26 23:01:41

【电商项目】商品搜索开发复盘(2):构造ES搜索条件逻辑实现与思考 目录一、整体思路二、分模块代码实现2.1 关键字条件2.2 品牌条件2.3 价格条件2.4 规格项条件2.5 分页处理2.6 排序处理最后返回代码整体展示本篇小结在1我们了解了大体实现思路这一篇我们实现第一个内容把前端传过来的JSON业务参数转换成ES客户端能够识别执行的查询格式。文章内容均为小编开发过程中思考的记录由于是新手所以很多地方不理解问题也就比较多发出来见笑了。一、整体思路处理流程接收参数 → 重新组装成ES查询语法先创建两个核心对象NativeQueryBuilder大容器存放完整的一次ES查询请求查询条件、分页、排序全部往里装BoolQuery.Builder布尔查询构造器专门拼装一个个小查询条件NativeQueryBuilder nativeQueryBuilder new NativeQueryBuilder(); BoolQuery.Builder builder new BoolQuery.Builder();我们直接看入参实体GoodsSearchParam就知道需要处理哪些条件关键字、品牌、价格、规格、排序、分页。遍历每一项参数按需拼装到布尔查询中。二、分模块代码实现每一个筛选条件统一思路接收参数做非空判断组装为ES可识别的查询对象。2.1 关键字条件逻辑没有关键字查询全部商品有关键字多字段全文检索。String keyword goodsSearchParam.getKeyword(); if(!StringUtils.hasText(keyword)){ MatchAllQuery matchAllQuery new MatchAllQuery.Builder().build(); builder.must(matchAllQuery._toQuery()); }else{ MultiMatchQuery multiMatchQuery MultiMatchQuery.of(q - q .query(keyword) .fields(goodsName, caption, brand)); builder.must(multiMatchQuery._toQuery()); }2.1.1 MatchAllQuery、MultiMatchQuery、_toQuery()是什么MatchAllQuery匹配全部文档用户不输入关键词时返回全部商品MultiMatchQuery多字段全文匹配会对关键词分词检索_toQuery()把具体查询对象转为ES客户端通用的Query类型统一交给布尔查询使用2.1.2 为什么MatchAllQuery需要.Builder().build()BoolQuery只需要.Builder()Builder是建造者只负责拼接参数调用build()才生成最终完整查询对象。BoolQuery.Builder我们后续还会持续追加条件所以暂时不buildMatchAllQuery参数一次性设置完毕直接build拿到对象。2.1.3builder.must(multiMatchQuery._toQuery())must()等价于SQL的AND里面的条件必须全部满足传入经过_toQuery()转换后的查询对象加入布尔查询。2.1.4 MultiMatchQuery为什么不用new实体化可以直接使用新版本ES Java客户端大量使用静态工厂方法of()替代new构造对象属于官方推荐写法。2.2 品牌条件品牌属于精准匹配不分词使用TermQuery。String brand goodsSearchParam.getBrand(); if(StringUtils.hasText(brand)){ TermQuery termQuery TermQuery.of(q - q .field(brand) .value(brand)); builder.must(termQuery._toQuery()); }2.2.1 TermQuery 和 MatchAllQuery 的区别TermQuery精确匹配不分词适合品牌、规格、ID这类确定值MatchAllQuery查询全部文档不做过滤2.2.2 为什么关键字用queryfields品牌用fieldvalue关键字是MultiMatchQuery全文检索关键词需要分词同时搜索多个字段。query是搜索词复数fields指定要检索的多个字段。品牌是TermQuery精准匹配明确知道要查哪一个字段单数field指定字段value填写完整匹配值。小技巧看到复数fields就是多字段全文搜索单数field一般是精准单字段查询。2.3 价格条件价格是数值区间使用RangeQuery做范围过滤。Double highPrice goodsSearchParam.getHighPrice(); Double lowPrice goodsSearchParam.getLowPrice(); if(highPrice ! null highPrice ! 0){ RangeQuery price RangeQuery.of(q - q .field(price) .lte(JsonData.of(highPrice))); builder.must(price._toQuery()); } if(lowPrice ! null lowPrice ! 0){ RangeQuery price RangeQuery.of(q - q .field(price) .gte(JsonData.of(lowPrice))); builder.must(price._toQuery()); }2.3.1 RangeQuery说明是专门用来做数值区间筛选的gte大于等于lte小于等于。2.3.2 为什么要用JsonData.of()包裹数值ES客户端强制要求把Java数值包装为JsonData明确告诉ES这是数字类型避免ES把数字当成字符串对比导致区间查询出错。2.4 规格项条件前端传规格JSON对象解析成Map循环每一组键值拼接ES字段路径生成TermQuery。MapString, String specificationOption goodsSearchParam.getSpecificationOption(); if(specificationOption ! null !specificationOption.isEmpty()){ SetMap.EntryString, String entrySet specificationOption.entrySet(); for (Map.EntryString, String es : entrySet) { String key es.getKey(); String value es.getValue(); TermQuery termQuery TermQuery.of( q - q .field(specification. key .keyword) .value(value)); builder.must(termQuery._toQuery()); } } nativeQueryBuilder.withQuery(builder.build()._toQuery());2.4.1 entrySet把Map拆成一堆键值对方便遍历2.4.2 entrySet已经拿到键值对为什么不能直接丢ES还要循环取key、valueentrySet只是Java集合对象ES不识别Map必须循环逐个构建TermQuery查询条件。2.4.3 Map本身存键值为什么要用entrySet不直接遍历Map的keySet、values是两套独立集合一轮循环拿不到成对key‑valueentrySet把一组keyvalue封装为Entry不用额外调用map.get(key)。2.4.4 entrySet 之后是不是如果没有 entrySet直接拿 key 和 value 会配对错乱是的。只遍历 keySet再遍历 values两个集合分开顺序不能保证一一对应容易键值匹配错误。Entry 把 key 和 value 绑定成一个单元遍历就不会乱。2.4.5 entrySet 是把键值对应然后形成一组组数据的吗不是。entrySet没法同时拿到一组配套的 keyvalue单独遍历 keySet 只拿到一堆键、遍历 values 只拿到一堆值两组集合分开没法保证顺序配对极易错乱。2.4.6 规格过滤为什么接收Map不用别的集合取决于前端传参。前端传{颜色:红,内存:16G}JSON 对象 → Spring 自动解析为 Map如果用ListSpec前端就得传数组格式[{key:颜色,value:红}]。 这里选 Map 是适配前端传参。2.4.7为什么 编写品牌时field直接写字段名brand而规格要拼接specification.key.keyword以及各部分含义是什么ES 文档层级不一样brand是顶层单层字段直接写字段名即可specification是嵌套对象里面规格名颜色 / 内存是动态变化的 key真实查询字段路径是specification.颜色.keyword字段名一部分运行时才确定代码只能字符串拼接完整路径。2.4.8 nativeQueryBuilder 和 builder.must 关系builder负责拼装一堆must条件拼装完成调用build生成完整布尔查询交给nativeQueryBuilder容器保存。逻辑前端规格 JSON → 解析为 Map → entrySet 得到 Entry 集合 → 循环取出成对 key、value → 拼接 ES 嵌套字段路径 → 循环生成 TermQuery 加入布尔查询完成规格过滤。2.5 分页处理PageRequest pageRequest PageRequest.of(goodsSearchParam.getPage() - 1, goodsSearchParam.getSize()); nativeQueryBuilder.withPageable(pageRequest);注意ES分页从0开始前端传的页码是从1开始所以要做减1处理。2.5.1 NativeQueryBuilder到底是什么相当于一个大箱子存放一次ES查询全部组件nativeQueryBuilder.withQuery(...)存放查询条件关键词、品牌、价格等nativeQueryBuilder.withPageable(...)存放分页信息nativeQueryBuilder.withSort(...)存放排序规则2.5.2 withQuery要build()_toQuery()withPageable直接传对象为什么BoolQuery.Builder是临时构造器必须build生成布尔查询对象再转统一Query对象这是查询条件的格式要求。 PageRequest本身就是Spring提供完整分页实体不需要构建转换直接传入即可。2.6 排序处理String sortFiled goodsSearchParam.getSortFiled(); // 排序字段 String sort goodsSearchParam.getSort(); // 排序方式 if (StringUtils.hasText(sortFiled) StringUtils.hasText(sort)){ Sort sortParam null; // 组装好的排序规则 // 新品的正序是id的倒序 if (sortFiled.equals(NEW)){ if (sort.equals(ASC)){ // 升序 sortParam Sort.by(Sort.Direction.DESC, id); // id从小到大 → 旧商品在前 } if (sort.equals(DESC)){ // 降序 sortParam Sort.by(Sort.Direction.ASC, id); // id从大到小 → 新商品在前 } } // 价格的正序是price的正序 if (sortFiled.equals(PRICE)){ if (sort.equals(ASC)){ sortParam Sort.by(Sort.Direction.ASC, price); } if (sort.equals(DESC)){ sortParam Sort.by(Sort.Direction.DESC, price); } } nativeQueryBuilder.withSort(sortParam); }2.6.1 变量说明sortFiled按什么维度排序NEW代表新品PRICE代表价格sort排序方向ASC升序DESC降序sortParamSpring Sort对象组装完成的排序规则Sort.by(Direction.DESC, id)创建排序规则第一个参数方向第二个ES字段名2.6.2 为什么只判断NEW和PRICE业务上商品搜索就两种常用排序按新品、按价格不需要支持任意字段排序。2.6.3 新品排序为什么逻辑是反转的id越大代表商品越新。业务认知选新品我们希望新商品排在最前面。前端传递的ASC/DESC不能直接拿来用需要手动转换映射到id字段。最后返回// 返回组装完毕的ES查询条件对象 return nativeQueryBuilder.build();代码整体展示/* * 构造搜索条件 * param goodsSearchParam 查询条件对象 * return 搜索条件对象 */ public NativeQuery buildQuery(GoodsSearchParam goodsSearchParam) { // 1.创建复杂查询条件对象 NativeQueryBuilder nativeQueryBuilder new NativeQueryBuilder(); BoolQuery.Builder builder new BoolQuery.Builder(); // 2.如果查询条件有关键词关键词可以匹配商品名、副标题、品牌字段否则查询所有商品 String keyword goodsSearchParam.getKeyword(); if(!StringUtils.hasText(keyword)){ MatchAllQuery matchAllQuery new MatchAllQuery.Builder().build(); builder.must(matchAllQuery._toQuery()); }else{ MultiMatchQuery multiMatchQuery MultiMatchQuery.of(q - q .query(keyword) .fields(goodsName, caption, brand)); builder.must(multiMatchQuery._toQuery()); } // 3.如果查询条件有品牌则精准匹配品牌 String brand goodsSearchParam.getBrand(); if(StringUtils.hasText(brand)){ TermQuery termQuery TermQuery.of(q - q .field(brand) .value(brand)); builder.must(termQuery._toQuery()); } // 4.如果查询条件有价格则匹配价格 Double highPrice goodsSearchParam.getHighPrice(); Double lowPrice goodsSearchParam.getLowPrice(); if(highPrice ! null highPrice ! 0){ RangeQuery price RangeQuery.of(q - q .field(price) .lte(JsonData.of(highPrice))); builder.must(price._toQuery()); } if(lowPrice ! null lowPrice ! 0){ RangeQuery price RangeQuery.of(q - q .field(price) .gte(JsonData.of(lowPrice))); builder.must(price._toQuery()); } // 5.如果查询条件有规格项则精准匹配规格项 MapString, String specificationOption goodsSearchParam.getSpecificationOption(); if(specificationOption ! null !specificationOption.isEmpty()){ SetMap.EntryString, String entrySet specificationOption.entrySet(); for (Map.EntryString, String es : entrySet) { String key es.getKey(); String value es.getValue(); TermQuery termQuery TermQuery.of( q - q .field(specification. key .keyword) .value(value)); builder.must(termQuery._toQuery()); } } nativeQueryBuilder.withQuery(builder.build()._toQuery()); // 6.添加分页条件 PageRequest pageRequest PageRequest.of(goodsSearchParam.getPage() - 1, goodsSearchParam.getSize()); nativeQueryBuilder.withPageable(pageRequest); // 7.如果查询条件有排序则添加排序条件 String sortFiled goodsSearchParam.getSortFiled(); // 排序字段 String sort goodsSearchParam.getSort(); // 排序方式 if (StringUtils.hasText(sortFiled) StringUtils.hasText(sort)){ Sort sortParam null; // 组装好的排序规则 // 新品的正序是id的倒序 if (sortFiled.equals(NEW)){ if (sort.equals(ASC)){ // 升序 sortParam Sort.by(Sort.Direction.DESC, id); // id从小到大 → 旧商品在前 } if (sort.equals(DESC)){ // 降序 sortParam Sort.by(Sort.Direction.ASC, id); // id从大到小 → 新商品在前 } } // 价格的正序是price的正序 if (sortFiled.equals(PRICE)){ if (sort.equals(ASC)){ sortParam Sort.by(Sort.Direction.ASC, price); } if (sort.equals(DESC)){ sortParam Sort.by(Sort.Direction.DESC, price); } } nativeQueryBuilder.withSort(sortParam); } // 8.返回查询条件对象 return nativeQueryBuilder.build(); }本篇小结整个过程本质就是翻译前端业务参数 → ES客户端对象。全文检索MultiMatchQuery精准匹配TermQuery数值区间RangeQuery所有小条件交给BoolQuery.Builder拼装全部条件、分页、排序统一装进NativeQueryBuilder容器
延伸阅读

更多相关文章

2026/10/24 17:51:09

双 RTX 4090 24G 部署 Qwen3.8-27B + MTP 投机解码实战记录

前言本人单位内部有一台双4090 24G的工作站,需要用它来部署Qwen3.8-27B。之前是3.6-35B-A3B,用来跑Hermes Agent速度还可以,但是同事给换到27B后,速度慢得离谱,于是想动手优化一下,最终加上 vLLM 的 MTP 投…

2026/10/24 16:00:07

Flutter 广告接入不再散落:用 ads_manager 统一管理 AdMob

一套 API 接入 Banner、插屏、激励、激励插屏、原生和开屏广告,让广告初始化、预加载、展示回调和收益统计更加简单。 适用版本:ads_manager 1.2.2 技术栈:Flutter、Dart、Google Mobile Ads、AdMob 【一、为什么需要 ads_manager&#xff…

2026/10/24 18:02:27

内存为什么越跑越高?从对象回收讲透内存泄漏的原因与预防

线上服务有一种问题很让人头疼:刚启动时一切正常。运行几个小时后,内存开始慢慢上涨。再过一段时间,接口变慢、GC 变频繁,最后甚至直接 OOM。很多时候,这背后就是一个很典型的问题:内存泄漏。不少人会把内存…

2026/10/26 22:57:18

e2e测试从选型到落地:搭建稳定可复现的端到端测试体系

做前端开发和测试的同学,对“e2e”这三个字母肯定不陌生,尤其是这两年,它在技术社区和招聘要求里出现的频率越来越高。但说实话,很多人对它的理解还停留在“模拟用户点点点”的层面,真正上手搭过一套稳定、可复现、能进…

2026/10/26 22:57:18

e2e测试:端到端质量保障的核心实践与工程落地

1. “e2e”不是缩写游戏,而是软件质量防线的最后一道闸门你打开一个网页,点登录按钮,输账号密码,跳转到首页——这个过程在你眼里是“顺手一刷”,但在开发团队眼里,它是一条由几十个接口调用、状态变更、DO…

2026/10/26 22:57:18

ComfyUI与LoRA技术:AI图像生成的高效工作流

1. ComfyUI与LoRA技术概述ComfyUI作为一款基于节点式工作流的AI图像生成工具,正在成为专业创作者的新宠。其可视化编程界面让复杂的工作流搭建变得直观可控,而LoRA(Low-Rank Adaptation)技术则是当前AI绘图领域实现模型微调的最高…

2026/10/26 22:57:18

seedance2:本地化短剧生成工作流引擎详解

简介:这是一套开源的本地化AI短剧与漫剧生成工具seedance2接入方案,面向影视创作者、AI应用开发者及短剧内容生产者,解决传统短剧制作流程长、依赖云端服务、数据隐私难保障等痛点。资源包共280个文件,含106个JavaScript核心逻辑文…

2026/10/26 22:57:18

多任务学习中的任务冲突解析与实战解决方案

1. 多任务学习中的任务冲突现象解析第一次接触多任务学习(MTL)时,我像发现新大陆一样兴奋——用一个模型同时解决多个任务,这简直是计算资源的完美利用。但现实很快给我上了一课:当我在图像识别项目中同时训练分类和分…

2026/10/26 22:52:15

AI智能体记忆管理:ReMe工具包架构与应用解析

1. ReMe项目概述:AI智能体的记忆管理革命在AI智能体开发领域,记忆管理一直是制约系统性能的关键瓶颈。传统智能体往往采用单一记忆存储模式,导致在处理复杂任务时出现信息检索效率低下、上下文关联断裂等问题。ReMe工具包的诞生,正…

2026/10/26 0:20:20

全国计算机二级C语言真题PDF高效刷题指南

简介:这份PDF是全国计算机二级C语言考试的试题与答案解析,专为备考二级C语言的考生准备。内容涵盖C语言特点与设计理念、程序基本组成单位、main函数执行流程、函数嵌套调用规则、标识符命名规范、整型实型字符型数据类型、八进制十六进制数合法形式、运…

2026/10/26 1:53:47

requests+BeautifulSoup:爬虫抓取h1标题的入门实战指南

简介:一份以实战为导向的Python爬虫入门资源,面向具备基本编程基础、希望快速掌握网络数据抓取的初学者,可解决从零编写简单爬虫的常见困惑。实例以requests库发送HTTP请求、BeautifulSoup解析HTML文档,完整演示从网页中提取 标题…

2026/10/26 0:20:17

递推最小二乘参数辨识MATLAB编程:二阶系统与渐消记忆实现

简介:这是一篇面向控制系统、信号处理与机器学习等领域学习者的最小二乘参数辨识程序说明文档。资源共包含一个docx格式文档,压缩包大小七十八KB,内容围绕递推最小二乘算法和渐消记忆最小二乘算法展开:先构造一个极点位于单位圆内…

2026/10/26 0:00:48

Nested Learning:解决AI灾难性遗忘的分层记忆架构

1. 为什么AI需要"记忆"能力?在传统深度学习模型中,我们常遇到一个根本性问题:模型在处理新任务时,往往会完全遗忘之前学到的知识。这种现象被业界称为"灾难性遗忘"(Catastrophic Forgetting)。想象一下&#…

2026/10/26 0:00:48

企业级大模型应用:OCR预处理、Dify编排与DeepSeek落地实战

1. 这不是“用大模型”,而是重构工作流的起点“大模型的应用和工具”——这八个字现在被贴在无数技术分享、招聘JD、内部立项书的标题栏里,但绝大多数人点进去后看到的,是零散的API调用示例、几个开源UI截图、或者一句“接入LLM就能降本增效”…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑