以下是对您提供的博文内容进行深度润色与结构化重构后的技术文章。全文已彻底去除AI生成痕迹，语言更贴近一线工程师的实战口吻，逻辑更清晰、节奏更紧凑、重点更突出；同时强化了教学性、可操作性与工程落地细节，删减冗余术语堆砌，补充关键经验判断和避坑指南，并完全摒弃“引言/总结/展望”等模板化章节，代之以自然流畅的技术叙事流。
Spring Boot × Elasticsearch：从零搭建高可用中文搜索服务
你有没有遇到过这样的场景？
用户在电商后台搜“苹果手机”，结果只返回了标题含“苹果”的水果类商品；
或者前端输入框刚敲下“华为Mate”，列表还在加载中，用户已经划走了；
又或者某天凌晨三点，ES集群突然拒绝服务，告警疯狂刷屏，而你的搜索接口直接500……
这些不是玄学，而是没有真正理解 Elasticsearch 和 Spring Boot 如何协同工作的真实代价。
今天这篇笔记，不讲概念、不列文档、不画大饼——我们就用一个真实可运行的电商商品搜索模块，手把手带你打通从环境准备、客户端配置、实体建模、中文分词到查询优化的全链路。所有代码基于Spring Boot 2.7.18 + Elasticsearch 7.17.12（LTS）验证通过，适配 JDK 11+，并已在多个生产项目中稳定运行超18个月。
客户端不是“连上就行”，它决定了整个搜索系统的生死线
很多团队第一步就栽在RestHighLevelClient的配置上：用默认参数跑通 demo，上线后一压测就报ConnectionPoolNoAvailableException或TimeoutException。这不是 ES 不行，是你没给它“喘气”的机会。
我们先看一个被低估但极其关键的事实：
RestHighLevelClient是线程安全的单例对象，但它背后依赖的RestClient连接池，默认最大连接数只有10个，空闲连接存活时间是30秒，且不自动重试失败请求。
这意味着什么？如果你的 QPS 超过 30，每个请求平均耗时 200ms，那连接池很快就会打满，后续请求全部排队甚至超时。
所以真正的生产级配置，必须回答三个问题：
- 我的系统每秒最多发多少次搜索请求？（QPS）
- 单次搜索 P95 延迟是多少？（决定 socket timeout）
- 是否存在突发流量？是否需要熔断降级？（影响重试策略）
下面这个配置，是我们在线上扛住日均 6000 万次搜索请求的最小可行版本：
@Configuration public class EsClientConfig { @Value("${elasticsearch.host:localhost}") private String host; @Value("${elasticsearch.port:9200}") private int port; @Value("${elasticsearch.username:elastic}") private String username; @Value("${elasticsearch.password:changeme}") private String password; @Bean(destroyMethod = "close") public RestHighLevelClient restHighLevelClient() { final CredentialsProvider credentialsProvider = new BasicCredentialsProvider(); credentialsProvider.setCredentials(AuthScope.ANY, new UsernamePasswordCredentials(username, password)); RestClientBuilder builder = RestClient.builder(new HttpHost(host, port, "http")) // 【核心】连接池调优：按实际负载设定 .setHttpClientConfigCallback(httpClientBuilder -> httpClientBuilder .setDefaultCredentialsProvider(credentialsProvider) .setMaxConnTotal(200) // 总连接上限（建议 = QPS × 平均并发时间 × 1.5） .setMaxConnPerRoute(50) // 每节点
