SpringBoot整合Elasticsearch实现全文检索功能

 更新时间:2026年04月07日 09:13:03   作者:希望永不加班  
本文介绍了使用Elasticsearch进行全文检索的方法,包括环境搭建、分词配置、CRUD操作、高亮查询、分页、聚合等功能,并展示了如何在SpringBoot中整合Elasticsearch以及如何处理常见问题,需要的朋友可以参考下

当项目里出现模糊搜索、关键词高亮、分词检索、热搜推荐、商品搜索、文章全文检索这类需求时,MySQL 的 like %xxx% 已经完全顶不住了,这时候就必须上专业的搜索引擎——Elasticsearch

它天生支持分布式、PB 级数据、毫秒级响应、强大的分词与聚合能力,是目前后端全文检索的标配方案。

这一篇从零带你整合 SpringBoot + ES,从环境搭建、分词配置、CRUD、高亮查询、分页、聚合、到真实业务场景。

一、Elasticsearch 适用场景

  • 商城商品搜索、店铺搜索
  • 文章/博客/文档全文检索
  • 日志检索、运维监控(ELK)
  • 热搜、联想词、推荐补全
  • 多条件筛选 + 排序 + 高亮
  • 高并发模糊查询

二、环境说明

  • SpringBoot 2.x/3.x
  • Elasticsearch 7.x / 8.x(本文以 7.x 为例)
  • IK 分词器(必须安装,中文检索必备)
  • Kibana(可选,用于调试 DSL)

三、引入 Maven 依赖

注意:SpringBoot 版本与 ES 版本必须严格对应,否则会报版本不兼容错。

<!-- Elasticsearch -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-elasticsearch</artifactId>
</dependency>
<!-- Lombok -->
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

四、application.yml 配置

spring:
  elasticsearch:
    uris: http://localhost:9200
    # 8.x 需要开启账号密码
    # username: elastic
    # password: 123456

五、核心注解说明

@Document:标记文档,映射 ES 索引

  • indexName:索引名(相当于数据库名)
  • shards:分片数
  • replicas:副本数

@Id:文档主键

  • @Field:字段类型、分词器配置
  • type = FieldType.Text:文本,可分词
  • type = FieldType.Keyword:不分词,精确匹配
  • analyzer = "ik_max_word":IK 分词(中文)

六、实体类构建(文章检索示例)

package com.demo.entity;
import lombok.Data;
import org.springframework.data.annotation.Id;
import org.springframework.data.elasticsearch.annotations.Document;
import org.springframework.data.elasticsearch.annotations.Field;
import org.springframework.data.elasticsearch.annotations.FieldType;
import java.time.LocalDateTime;
@Data
@Document(
        indexName = "article",
        shards = 1,
        replicas = 0
)
public class ArticleES {
    @Id
    private Long id;
    // 标题:分词检索
    @Field(type = FieldType.Text, analyzer = "ik_max_word", searchAnalyzer = "ik_max_word")
    private String title;
    // 内容:全文检索
    @Field(type = FieldType.Text, analyzer = "ik_max_word", searchAnalyzer = "ik_max_word")
    private String content;
    // 作者:精确匹配,不分词
    @Field(type = FieldType.Keyword)
    private String author;
    // 浏览量
    @Field(type = FieldType.Integer)
    private Integer viewCount;
    // 分类
    @Field(type = FieldType.Keyword)
    private String category;
    @Field(type = FieldType.Date)
    private LocalDateTime createTime;
}

七、两种操作方式

SpringBoot 操作 ES 主要两种方式:

  1. ElasticsearchRepository:简单 CRUD,类似 JPA
  2. ElasticsearchTemplate / ElasticsearchRestTemplate:复杂高亮、聚合、多条件查询

方式一:Repository 快速 CRUD

1. 定义 Repository

package com.demo.repository;
import com.demo.entity.ArticleES;
import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;
import org.springframework.stereotype.Repository;
import java.util.List;
@Repository
public interface ArticleESRepository extends ElasticsearchRepository<ArticleES, Long> {
    // 根据标题检索
    List<ArticleES> findByTitle(String title);
}

2. 基础增删改查

@Service
@RequiredArgsConstructor
public class ArticleESService {
    private final ArticleESRepository repository;
    // 新增/更新文档
    public ArticleES save(ArticleES articleES) {
        return repository.save(articleES);
    }
    // 根据ID查询
    public ArticleES findById(Long id) {
        return repository.findById(id).orElse(null);
    }
    // 查询全部
    public Iterable<ArticleES> findAll() {
        return repository.findAll();
    }
    // 删除
    public void deleteById(Long id) {
        repository.deleteById(id);
    }
}

方式二:RestTemplate 复杂查询

支持高亮、多条件、分页、排序、模糊、范围、must/should 组合

1. 全文检索 + 高亮显示

@Autowired
private ElasticsearchRestTemplate restTemplate;
public List<ArticleES> search(String keyword) {
    // 1. 构建查询条件:标题 or 内容匹配关键词
    NativeSearchQuery query = new NativeSearchQueryBuilder()
            .withQuery(QueryBuilders.multiMatchQuery(keyword, "title", "content"))
            // 高亮配置
            .withHighlightFields(
                    new HighlightBuilder.Field("title").preTags("<span style='color:red'>").postTags("</span>"),
                    new HighlightBuilder.Field("content").preTags("<span style='color:red'>").postTags("</span>")
            )
            // 分页
            .withPageable(PageRequest.of(0, 10))
            // 排序
            .withSort(SortBuilders.fieldSort("viewCount").order(SortOrder.DESC))
            .build();
    // 2. 执行查询
    SearchHits<ArticleES> searchHits = restTemplate.search(query, ArticleES.class);
    // 3. 处理高亮结果
    List<ArticleES> resultList = new ArrayList<>();
    for (SearchHit<ArticleES> hit : searchHits.getSearchHits()) {
        ArticleES article = hit.getContent();
        // 替换高亮标题
        Map<String, List<String>> highlightFields = hit.getHighlightFields();
        if (highlightFields.containsKey("title")) {
            article.setTitle(highlightFields.get("title").get(0));
        }
        if (highlightFields.containsKey("content")) {
            article.setContent(highlightFields.get("content").get(0));
        }
        resultList.add(article);
    }
    return resultList;
}

八、更多常用查询示例

1. 精确匹配(must)

.withQuery(QueryBuilders.boolQuery()
        .must(QueryBuilders.termQuery("category", "Java"))
        .must(QueryBuilders.rangeQuery("viewCount").gte(100))
)

2. 或查询(should)

.withQuery(QueryBuilders.boolQuery()
        .should(QueryBuilders.matchQuery("title", "SpringBoot"))
        .should(QueryBuilders.matchQuery("content", "Redis"))
)

3. 范围查询

QueryBuilders.rangeQuery("viewCount").gte(100).lte(10000)

4. 模糊查询

QueryBuilders.fuzzyQuery("title", "SpringBoot")

5. 聚合查询(按分类统计数量)

.withAggregation(AggregationBuilders.terms("group_category").field("category"))

九、数据同步(MySQL ↔ ES)

企业级必须做数据同步,常见方案:

  1. 简单方案:新增/更新数据库时,同步更新 ES
  2. 中间件方案:Canal / Debezium 监听 binlog 自动同步
  3. 定时任务:适合数据实时性要求不高的场景

十、IK 分词器(中文必备)

安装后才能正确拆分中文

支持自定义扩展词库(如:Java、SpringBoot、云原生)

分词模式:

  • ik_max_word:最细粒度拆分
  • ik_smart:粗粒度拆分

十一、注意事项

1. SpringBoot 与 ES 版本不兼容 → 启动直接报错

2. 未安装 IK 分词 → 中文搜索效果极差

3. keyword 不能模糊查询 → 必须用 text + 分词

4. 高亮不生效 → 字段名与查询不匹配

5. 深度分页性能差 → 尽量用 scroll 或 search_after

6. 索引不存在 → 自动创建或手动创建索引

十二、总结

SpringBoot 整合 Elasticsearch 是全文检索的标准方案

  • 引入依赖 → 配置连接 → 定义文档 → 构建查询
  • 简单 CRUD 用 Repository
  • 复杂高亮、多条件、聚合用 RestTemplate

你们项目里用 ES 做什么业务?遇到过分词、同步、性能问题吗?

以上就是SpringBoot整合Elasticsearch实现全文检索功能的详细内容,更多关于SpringBoot Elasticsearch全文检索的资料请关注脚本之家其它相关文章!

相关文章

  • java遍历http请求request的所有参数实现方法

    java遍历http请求request的所有参数实现方法

    下面小编就为大家带来一篇java遍历http请求request的所有参数实现方法。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2016-09-09
  • 解析如何开发FineReport的自定义控件

    解析如何开发FineReport的自定义控件

    FineReport作为插件化开发的报表软件,有些特殊需求的功能需要自己开发,开发的插件包帆软官方有提提供,可以去帆软论坛上找,本文将主要介绍如何开发一个自定义控件,这里讲讲方法论。需要的朋友一起来看下吧
    2016-12-12
  • Java实战之制作在线音乐网站

    Java实战之制作在线音乐网站

    这篇文章主要介绍了如何通过Java实现一个精美风的在线音乐网站,文章采用到了JSP、JQuery、Ajax等技术,感兴趣的小伙伴可以了解一下
    2022-02-02
  • IDEA新建javaWeb以及Servlet简单实现小结

    IDEA新建javaWeb以及Servlet简单实现小结

    这篇文章主要介绍了IDEA新建javaWeb以及Servlet简单实现小结,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-11-11
  • java实现超市管理系统

    java实现超市管理系统

    这篇文章主要为大家详细介绍了java实现超市管理系统,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2020-12-12
  • Java_Spring之Spring 中的事务控制

    Java_Spring之Spring 中的事务控制

    这篇文章主要介绍了Java Spring中的事务控制,事务控制要明确内容,事务的控制都是基于AOP的,感兴趣的小伙伴可以参考阅读本文
    2023-04-04
  • 深度解析Spring内置作用域及其在实践中的应用

    深度解析Spring内置作用域及其在实践中的应用

    这篇文章主要详细介绍了Spring内置的作用域类型及其在实践中的应用,文中有详细的代码示例,对我们的饿学习或工作有一定的参考价值,感兴趣的同学可以借鉴阅读
    2023-06-06
  • JAVA中通过Redis实现延时任务demo实例

    JAVA中通过Redis实现延时任务demo实例

    Redis在2.0版本时引入了发布订阅(pub/sub)功能,在发布订阅中有一个channel(频道),与消息队列中的topic(主题)类似,可以通过redis的发布订阅者模式实现延时任务功能,实例中会议室预约系统,用户预约管理员审核后生效,如未审批,需要自动变超期未处理,使用延时任务
    2024-08-08
  • Java简单有效实现将PDF转换为TIFF图片

    Java简单有效实现将PDF转换为TIFF图片

    在日常开发中,我们常需要将 PDF 转换为高质量的 TIFF 图片,本文将通过 Java 提供一个简单高效的解决方案,帮助你轻松完成 PDF 到 TIFF 的转换,并支持批量与多页处理,有需要的可以参考一下
    2025-09-09
  • SpringBoot通过注解监测Controller接口的代码示例

    SpringBoot通过注解监测Controller接口的代码示例

    在Spring Boot中,度量指标(Metrics)是监控和诊断应用性能与行为的重要工具,Spring Boot通过集成Micrometer和Spring Boot Actuator,提供了强大的度量指标收集与暴露功能,本文介绍了SpringBoot通过注解监测Controller接口,需要的朋友可以参考下
    2024-07-07

最新评论