百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

Spring Boot 集成 Elasticsearch 全攻略

nanshan 2025-07-03 18:19 4 浏览 0 评论

在当今大数据和高并发的时代背景下,高效的数据检索和分析成为众多应用系统的核心需求。Elasticsearch(简称 ES)作为一款开源的分布式搜索引擎,以其强大的全文检索、实时分析和水平扩展能力,受到了开发者们的广泛青睐。而 Spring Boot 凭借其快速构建、自动配置的特性,极大地简化了 Java 应用的开发过程。将 Spring Boot 与 Elasticsearch 集成,能够充分发挥两者的优势,为应用系统提供高效、灵活的数据检索解决方案。接下来,我们就详细介绍如何在 Spring Boot 项目中集成 Elasticsearch。

一、环境准备

在开始集成之前,确保你已经安装好了以下环境:

  1. JDK:推荐使用 JDK 8 及以上版本。
  2. Elasticsearch:下载并安装合适版本的 Elasticsearch,安装完成后启动 ES 服务。可以通过访问http://localhost:9200/,若能看到 ES 的欢迎信息,说明 ES 服务正常运行。
  3. Spring Boot 项目:可以通过 Spring Initializr(https://start.spring.io/)创建一个基础的 Spring Boot 项目,在创建时勾选Spring Data Elasticsearch依赖,方便后续集成。

二、添加依赖

如果在创建 Spring Boot 项目时没有勾选Spring Data Elasticsearch依赖,也可以在项目的pom.xml文件中手动添加:

<dependencies>

<!-- Spring Data Elasticsearch 依赖 -->

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-data-elasticsearch</artifactId>

</dependency>

<!-- Spring Boot 测试依赖 -->

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-test</artifactId>

<scope>test</scope>

</dependency>

</dependencies>

添加完依赖后,Maven 会自动下载相关的 jar 包。

三、配置 Elasticsearch 连接

在application.properties或application.yml文件中配置 Elasticsearch 的连接信息。以application.yml为例:

spring:

data:

elasticsearch:

cluster-name: elasticsearch # ES集群名称,默认为elasticsearch

cluster-nodes: localhost:9300 # ES节点地址,9300为传输端口,若使用默认配置可不修改

# 或者使用以下配置方式,适用于REST API连接

# uri: http://localhost:9200

如果使用的是 Elasticsearch 的 REST API 进行交互,也可以使用uri配置项,直接指定 ES 的 HTTP 访问地址。

四、创建实体类

创建一个 Java 实体类,用于映射 Elasticsearch 中的文档。假设我们有一个简单的博客文章实体类Blog:

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;

@Document(indexName = "blog", type = "_doc", shards = 1, replicas = 0)

public class Blog {

@Id

private String id;

@Field(type = FieldType.Text)

private String title;

@Field(type = FieldType.Text)

private String content;

// 省略getter和setter方法

}

在上述代码中:

  • @Document注解用于定义该实体类对应的 Elasticsearch 索引名称、文档类型、分片数和副本数。
  • @Id注解标识该字段为文档的唯一标识。
  • @Field注解用于指定字段的类型等属性,这里将title和content字段定义为Text类型,适合进行全文检索。

五、创建 Repository 接口

创建一个继承自ElasticsearchRepository的接口,用于对 Elasticsearch 进行数据操作:

import org.springframework.data.elasticsearch.repository.ElasticsearchRepository;

import java.util.List;

public interface BlogRepository extends ElasticsearchRepository<Blog, String> {

List<Blog> findByTitleContaining(String keyword);

}

在这个接口中,我们定义了一个自定义方法findByTitleContaining,它会根据方法名的约定,自动生成查询语句,用于查找标题中包含指定关键字的博客文章。同时,ElasticsearchRepository已经提供了许多常用的 CRUD 操作方法,如save、findById、delete等,可以直接使用。

六、编写业务逻辑和测试代码

在服务类中注入BlogRepository,并编写业务逻辑方法。例如,创建一个BlogService类:

import org.springframework.stereotype.Service;

import java.util.List;

import java.util.Optional;

@Service

public class BlogService {

private final BlogRepository blogRepository;

public BlogService(BlogRepository blogRepository) {

this.blogRepository = blogRepository;

}

public Blog saveBlog(Blog blog) {

return blogRepository.save(blog);

}

public Optional<Blog> findBlogById(String id) {

return blogRepository.findById(id);

}

public List<Blog> searchBlogs(String keyword) {

return blogRepository.findByTitleContaining(keyword);

}

public void deleteBlogById(String id) {

blogRepository.deleteById(id);

}

}

接下来,可以编写测试代码对集成功能进行验证。在src/test/java目录下的测试类中编写如下测试方法:

import org.junit.jupiter.api.Test;

import org.springframework.beans.factory.annotation.Autowired;

import org.springframework.boot.test.context.SpringBootTest;

import java.util.Optional;

import static org.junit.jupiter.api.Assertions.*;

@SpringBootTest

public class BlogServiceTest {

@Autowired

private BlogService blogService;

@Test

public void testSaveAndFindBlog() {

Blog blog = new Blog();

blog.setTitle("Spring Boot集成ES测试文章");

blog.setContent("这是一篇用于测试的文章内容");

Blog savedBlog = blogService.saveBlog(blog);

assertNotNull(savedBlog.getId());

Optional<Blog> retrievedBlog = blogService.findBlogById(savedBlog.getId());

assertTrue(retrievedBlog.isPresent());

assertEquals("Spring Boot集成ES测试文章", retrievedBlog.get().getTitle());

}

@Test

public void testSearchBlogs() {

Blog blog1 = new Blog();

blog1.setTitle("Spring Boot入门教程");

blog1.setContent("详细介绍Spring Boot入门知识");

blogService.saveBlog(blog1);

Blog blog2 = new Blog();

blog2.setTitle("Elasticsearch实战");

blog2.setContent("分享Elasticsearch的实战经验");

blogService.saveBlog(blog2);

List<Blog> searchResults = blogService.searchBlogs("Spring Boot");

assertEquals(1, searchResults.size());

assertEquals("Spring Boot入门教程", searchResults.get(0).getTitle());

}

}

运行这些测试方法,如果都能顺利通过,说明 Spring Boot 与 Elasticsearch 的集成基本成功。

七、高级配置与优化

1. 自定义 ElasticsearchTemplate

除了使用ElasticsearchRepository,还可以通过ElasticsearchTemplate进行更灵活的操作。在配置类中注入ElasticsearchTemplate:

import org.springframework.context.annotation.Bean;

import org.springframework.context.annotation.Configuration;

import org.springframework.data.elasticsearch.core.ElasticsearchTemplate;

import org.springframework.data.elasticsearch.repository.config.EnableElasticsearchRepositories;

@Configuration

@EnableElasticsearchRepositories(basePackages = "com.example.demo.repository")

public class ElasticsearchConfig {

@Bean

public ElasticsearchTemplate elasticsearchTemplate() {

return new ElasticsearchTemplate(elasticsearchClient());

}

// 省略elasticsearchClient方法的定义,根据实际连接方式编写

}

然后在业务类中注入ElasticsearchTemplate,就可以使用它执行复杂的查询、聚合等操作。

2. 性能优化

  • 索引设置优化:合理设置索引的分片数和副本数,根据数据量和查询负载进行调整。一般来说,分片数在创建索引后不能轻易修改,而副本数可以动态调整。
  • 批量操作:对于大量数据的插入或更新,可以使用ElasticsearchRepository的批量操作方法,或者通过ElasticsearchTemplate执行批量请求,减少与 ES 的交互次数,提高性能。
  • 缓存策略:对于一些不经常变化的数据,可以在应用层添加缓存,减少对 Elasticsearch 的查询压力。

八、常见问题与解决

1. 连接超时问题

如果出现连接 Elasticsearch 超时的情况,可能是 ES 服务未正常启动,或者网络配置有误。检查 ES 服务状态,确保cluster-nodes或uri配置的地址和端口正确。如果 ES 设置了安全认证,还需要在连接配置中添加用户名和密码。

2. 映射冲突问题

当实体类的字段类型与 Elasticsearch 索引的映射不匹配时,会出现映射冲突。可以通过手动创建索引并定义映射,或者使用ElasticsearchTemplate的putMapping方法动态更新映射。

3. 依赖版本兼容问题

Spring Data Elasticsearch 与 Elasticsearch 的版本需要保持兼容,否则可能会出现各种异常。在选择依赖版本时,参考官方文档的版本兼容性说明。

通过以上步骤,我们完成了 Spring Boot 与 Elasticsearch 的集成,并实现了基本的数据操作和查询功能。在实际项目中,可以根据具体需求进一步扩展和优化,利用 Elasticsearch 强大的搜索和分析能力,为应用系统提供更高效的数据服务。

以上就是 Spring Boot 集成 ES 的完整流程与要点。若你在实践中遇到特定问题,或想了解某部分的拓展内容,欢迎随时和我说。

相关推荐

在 Ubuntu 上安装 Zabbix(以 Zabbix 6.4 LTS 版本为例)

Zabbix是一个流行的开源监控解决方案,能够监控各种网络参数和服务器健康状态。一、环境准备系统要求Ubuntu20.04/22.04LTS至少2GBRAM(生产环境建议4GB+)至少1...

如何在 Ubuntu 24.04 服务器上安装 Apache Solr

ApacheSolr是一个免费、开源的搜索平台,广泛应用于实时索引。其强大的可扩展性和容错能力使其在高流量互联网场景下表现优异。Solr基于Java开发,提供了分布式索引、复制、负载均衡及自...

如何在 Ubuntu 24.04 LTS 或 22.04/20.04 上安装 Apache Maven

Maven是由Apache托管的开源工具,用于管理Java项目。它包含一个项目对象模型(POM):一个配置文件(XML),其中包含项目的基本信息,包括配置、项目依赖项等。Maven可以处理...

Cursor的终极对手——Trae Pro最新系统提示词

前段时间,字节的AI编程神器Trae国际版,终于甩出了Pro订阅计划!很多对它又爱又恨的小伙伴,直呼:终于等到你。爱它,是因为Trae长期免费+体验真香;恨它?还不是那该死的排队等待,...

AI系统提示词:V0(ai代码提示)

以下是对V0系统提示词(SystemPrompt)的分部分讲解与解读,帮助你理解其核心内容和设计意图。V0系统提示词##CoreIdentity-Youarev0,Vercel&...

8岁男童失踪第13天,搜救人员发现可疑水库,更恶心的事情发生了

Lookingatyourrequest,Ineedtorewritethearticleaboutthe8-year-oldmissingboywhilemaking...

docker常用指令及安装rabbitMQ(docker安装zabbix)

一、docker常用指令启动docker:systemctlstartdocker停止docker:systemctlstopdocker重启docker:systemctlrestart...

三步教你用Elasticsearch+PyMuPDF实现PDF大文件秒搜!

面对100页以上的大型PDF文件时,阅读和搜索往往效率低下。传统关系型数据库在处理此类数据时容易遇到性能瓶颈,而Elasticsearch凭借其强大的全文检索和分布式架构,成为理想解决方案。通过...

ElasticSearch中文分词插件(IK)安装

坚持原创,共同进步!请关注我,后续分享更精彩!!!前言ElasticSearch默认的分词插件对中文支持很不友好。一段话按规则会以每个中文字符来拆解,再分别建立倒排索引。如"中华人民共和国国歌...

SpringBoot使用ElasticSearch做文档对象的持久化存储?

ElasticSearch是一个基于Lucene的开源搜索引擎,广泛应用于日志分析、全文搜索、复杂查询等领域,在有些场景中使用ElasticSearch进行文档对象的持久化存储是一个很不错的选择...

Elasticsearch数据迁移方案(elasticsearch copyto)

前言最近小编要去给客户部署一套系统涉及到了Mysql和ES数据的迁移,下面就给大家分享一下ES数据迁移的几套方案,根据具体的使用场景来选择不同的迁移方案能使你事倍功半,话多说下面就一一介绍。Elast...

Rancher部署单体ElasticSearch(rancher2.5部署)

Rancher是k8s图形管理界面,之前曾有写文章介绍如何安装。ElasticSearch是热门搜索引擎,很多地方都有用到,常规安装部署略显繁琐,本文介绍在k8s下用rancher简易部署ES。1.在...

Elasticsearch在Java项目的搜索实践:从零开始构建高效搜索系统

Elasticsearch在Java项目中的搜索实践:从零开始构建高效搜索系统在现代的Java项目中,数据量激增,传统的数据库查询方式已经无法满足快速检索的需求。这时,Elasticsearch(E...

小白入门-Kibana安装(kibana安装配置)

一Kibana基础1.1介绍Kibana是一款免费且开放的前端应用程序,其基础是ElasticStack,可以为Elasticsearch中索引的数据提供搜索和数据可视化功能。Kiban...

Docker上使用Elasticsearch,Logstash,Kibana

在对一个项目做性能测试时我需要处理我们web服务器的访问日志来分析当前用户的访问情况。因此,我想这是试用ELK的一个好机会。ELK栈首先要注意的是使用它是非常简单的。从决定使用ELK到在本机上搭一个...

取消回复欢迎 发表评论: