Spring Boot 集成 Elasticsearch 实现全文检索的核心是正确配置 spring-boot-starter-data-elasticsearch、严格对齐版本、集成 IK 中文分词器、显式指定 analyzer 与 searchAnalyzer，并使用 ElasticsearchOperations 编写 DSL 保证查得准、响应快、结果可读。
Spring Boot 集成 Elasticsearch 实现全文检索，核心是用好 spring-boot-starter-data-elasticsearch，配合正确的版本对齐、中文分词配置和实体映射。关键不在“能不能连上”，而在于“查得准、响应快、结果可读”——尤其是中文场景下，漏掉 IK 或 jieba 分词器，搜索基本等于摆设。
确保版本严格匹配
Spring Boot 与 Elasticsearch 版本不兼容是高频报错根源。不是“差不多就行”，而是必须精确对应：
- Spring Boot 2.7.x → 推荐 ES 7.17.x（
spring-boot-starter-data-elasticsearch自带 RestClient） - Spring Boot 3.2+ → 必须用 ES 8.11+，且依赖自动切换为
elasticsearch-java+spring-elasticsearch - 别直接抄旧教程的
cluster-nodes或transport配置——ES 7.0+ 已弃用 TransportClient，8.x 完全移除
正确配置连接与认证
application.yml 示例（以 ES 8.12 为例）：
spring:
elasticsearch:
uris: http://localhost:9200
username: elastic
password: your-actual-password # 启动时 Docker 日志会打印初始密码
注意：
– 不要写 spring.data.elasticsearch.cluster-nodes（已过时）
– 若用 Docker 启动 ES 8.x，必须加 -e "discovery.type=single-node"，否则启动失败
– Kibana 可选但强烈建议装，用于手动验证索引结构和 DSL 查询
中文检索必须配分词器
ES 默认分词器对中文是“按字切”，搜“智能手机”会拆成“智”“能”“手”“机”，无法匹配完整词。解决方式：
- 安装 IK 分词器（推荐
ik_max_word）：进入 ES 容器执行bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.12.2/elasticsearch-analysis-ik-8.12.2.zip - 实体字段显式指定分词器：
@Field(type = FieldType.Text, analyzer = "ik_max_word", searchAnalyzer = "ik_smart") - 避免在
@Field中漏写searchAnalyzer，否则查询时仍用默认分词，导致“存得进、搜不出”
实体类与搜索逻辑落地
以商品搜索为例：
- 实体类用
@Document(indexName = "products")声明索引名 - 标题、描述字段用
FieldType.Text + ik_max_word；品牌、分类用FieldType.Keyword支持精准筛选 - 高亮需在查询时构造
NativeSearchQueryBuilder，设置highlightFields并指定preTags/postTags - 聚合统计（如按价格区间、品牌分组）直接用
AggregationBuilders.terms("brand_agg").field("brand.keyword")
Repository 层继承 ElasticsearchRepository<Product, String> 即可复用 findByXXXContaining 等方法，但复杂查询建议用 ElasticsearchOperations 手写 DSL，更可控。
