spring boot 整合 elasticsearch 实现高性能全文检索需确保版本严格兼容、中文分词器（如 ik）正确安装、实体字段按语义精准建模（text+analyzer / keyword），并使用 elasticsearchoperations 构建 dsl 支持高亮、分页与多条件组合查询。
直接用 Spring Boot 整合 Elasticsearch 实现高性能全文检索，关键不在“能不能”，而在“怎么配对、怎么建模、怎么查得准又快”。核心是版本对齐、中文分词到位、查询逻辑贴业务，而不是堆配置。
确认版本兼容性，避免启动就报错
Spring Boot、Spring Data Elasticsearch 和 Elasticsearch 服务端三者必须严格匹配，否则连应用都起不来。
- Spring Boot 2.7.x → Spring Data Elasticsearch 4.4.x → Elasticsearch 7.10–8.6
- Spring Boot 3.x → Spring Data Elasticsearch 5.x → Elasticsearch 8.0+
- 检查方式：运行
curl http://localhost:9200看返回 JSON 中的version.number；查 pom.xml 的spring-boot-starter-parent版本；再对照官方兼容矩阵
快速启动 ES 服务（推荐 Docker）
本地开发不建议手动装 Java 环境+ES，Docker 一行命令搞定，且可关安全认证省去初期干扰。
- 创建目录并授权：
mkdir -p /opt/es8/{data,plugins} && chmod 777 /opt/es8/data /opt/es8/plugins - 运行容器（以 8.15.2 为例）：
docker run -d --name es8 -p 9200:9200 -p 9300:9300 -e discovery.type=single-node -e xpack.security.enabled=false -v /opt/es8/data:/usr/share/elasticsearch/data -v /opt/es8/plugins:/usr/share/elasticsearch/plugins elasticsearch:8.15.2 - 验证健康状态：
curl -X GET "http://localhost:9200/_cat/health?v"，返回green即可用 - 中文检索必装 IK 分词器：进入容器执行
bin/elasticsearch-plugin install https://github.com/medcl/elasticsearch-analysis-ik/releases/download/v8.15.2/elasticsearch-analysis-ik-8.15.2.zip
定义实体与索引结构，让字段“会分词”
ES 不是数据库，字段类型和分词器选错，搜索就永远不命中。重点在 @Field 的 type 和 analyzer。
-
FieldType.Text：用于全文检索字段（如标题、正文），必须配中文分词器，例如analyzer = "ik_max_word" -
FieldType.Keyword：用于精确匹配（如 ID、状态、分类编码），不分词，大小写敏感 -
@Document(indexName = "articles", shards = 1, replicas = 0)：开发环境副本设为 0 可提速；生产按需设 1–2 - 示例字段：
@Field(type = FieldType.Text, analyzer = "ik_max_word") private String title;
实现高亮+分页+多条件组合查询
真实业务不是只查一个关键词，而是“含某词 + 某时间范围 + 某分类 + 排序 + 高亮显示”，靠 Repository 简单方法不够，得用 ElasticsearchOperations 写 DSL 或构建 NativeSearchQueryBuilder。
- 高亮配置：
.withHighlightBuilder(HighlightBuilders.field("title").preTags("<em>").postTags("</em>")) - 分页控制：
.withPageable(PageRequest.of(0, 20))，避免深度分页（from + size > 10000时改用 search_after） - 组合条件：
must(...).filter(rangeQuery("publishTime").gte("2025-01-01")) - 返回结果中通过
highlightFields()提取高亮片段，再替换原文对应字段
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
