<think>
我们首先需要明确，在
Spring Boot项目中
使用Elasticsearch（ES）进行
查询，通常有两种主要方式：
1.
使用Spring Data
Elasticsearch（这是
Spring Data项目的一部分）提供的Repository抽象。
2. 直接
使用Elasticsearch的RestHighLevelClient（在较新版本中，官方推荐
使用新的
Java客户端，但
Spring Data
Elasticsearch目前主要还是基于RestHighLevelClient，不过从
Spring Data
Elasticsearch 4.0开始，支持
使用新的
Java客户端，但这里我们以常用的方式为例）。
由于问题中提到了是新手学习，我们将介绍
使用Spring Data
Elasticsearch的方式，因为它更简单，更符合
Spring Boot的风格。
步骤：
1. 添加依赖
2. 配置
Elasticsearch
3. 创建实体类（映射ES的索引）
4. 创建Repository接口
5. 编写
查询方法或
使用自定义
查询
下面我们详细说明每一步。
1. 添加依赖
在pom.xml中添加
Spring Data
Elasticsearch的依赖。注意版本要与你的
Spring Boot版本兼容。
例如，对于
Spring Boot 2.3.x，可以添加：
```xml
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-
boot-starter-data-
elasticsearch</artifactId>
</dependency>
```
2. 配置
Elasticsearch
在application.properties或application.yml中配置
Elasticsearch的连接信息。
例如，在application.properties中：
```properties
spring.
elasticsearch.rest.uris=http://localhost:9200
# 如果集群有多个节点，可以配置多个，用逗号分隔
# 如果你的ES需要用户名密码，可以配置
spring.
elasticsearch.rest.username=your-username
spring.
elasticsearch.rest.password=your-password
```
3. 创建实体类
使用@Document注解指定索引名称，
使用@Id指定文档ID，
使用@Field指定字段映射（如类型、分析器等）。
例如：
```
java
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 = "book")
public class Book {
@Id
private String id;
@Field(type = FieldType.Text)
private String title;
@Field(type = FieldType.Text)
private String author;
// 省略构造方法、getter和setter
}
```
4. 创建Repository接口
创建一个接口，继承
ElasticsearchRepository，该接口提供了一些基本的CRUD方法和
查询方法。
例如：
```
java
import org.
springframework.data.
elasticsearch.repository.
ElasticsearchRepository;
public interface BookRepository extends
ElasticsearchRepository<Book, String> {
// 可以根据方法名自动生成
查询
List<Book> findByTitle(String title);
// 也可以
使用@Query注解自定义
查询
@Query("{\"match\": {\"title\": {\"query\": \"?0\"}}}")
List<Book> findByTitleCustom(String title);
}
```
5.
使用Repository进行
查询
在Service或Controller中注入BookRepository，然后调用其方法。
例如：
```
java
@Service
public class BookService {
@Autowired
private BookRepository bookRepository;
public List<Book> searchByTitle(String title) {
return bookRepository.findByTitle(title);
}
}
```
除了
使用Spring Data提供的方法命名约定自动生成
查询，还可以
使用ElasticsearchTemplate（或RestTemplate）进行更复杂的操作。
另外，如果
查询条件复杂，可以自定义Repository实现，具体步骤：
- 定义一个自定义接口，例如CustomBookRepository，其中声明自定义方法。
- 创建一个实现类，命名为CustomBookRepositoryImpl，实现自定义接口。
- 让BookRepository接口同时继承CustomBookRepository。
在实现类中，可以
使用ElasticsearchOperations（原
ElasticsearchTemplate）来
构建查询。
示例自定义实现：
```
java
public class CustomBookRepositoryImpl implements CustomBookRepository {
private final
ElasticsearchOperations
elasticsearchOperations;
public CustomBookRepositoryImpl(
ElasticsearchOperations
elasticsearchOperations) {
this.
elasticsearchOperations =
elasticsearchOperations;
}
@Override
public List<Book> customSearch(String searchTerm) {
//
构建查询
Query query = new NativeSearchQueryBuilder()
.withQuery(
QueryBuilders.matchQuery("title", searchTerm))
.build();
return
elasticsearchOperations.search(query, Book.class).stream()
.map(SearchHit::getContent)
.collect(Collectors.toList());
}
}
```
然后，修改BookRepository：
```
java
public interface BookRepository extends
ElasticsearchRepository<Book, String>, CustomBookRepository {
// ...
}
```
注意：在
Spring Data中，自定义实现类的命名规则是：接口名+Impl（默认），也可以通过配置修改。
以上就是
Spring Boot中集成
Elasticsearch进行
查询的基本步骤。
解释：
使用Spring Data
Elasticsearch可以简化与
Elasticsearch的交互，它提供了类似于
Spring Data JPA的编程模型。通过定义Repository接口，我们可以轻松地执行各种
查询，而无需编写大量的样板代码。对于复杂的
查询，我们可以通过自定义接口和实现类，
使用ElasticsearchOperations来
构建查询。
最后，注意版本兼容性问题，
Spring Data
Elasticsearch的版本需要与
Elasticsearch服务器版本匹配，否则可能出现不兼容的情况。
相关问题：
§§相关问题§§:
1. 如何配置
Spring Boot项目以连接多个
Elasticsearch节点？
2. 在
Spring Data
Elasticsearch中，如何实现复杂
查询（例如布尔
查询、范围
查询）？
3. 如何更新
Elasticsearch中的文档？
4. 如何处理
Elasticsearch的版本兼容性问题？
</think>### 在
Spring Boot中
使用Elasticsearch进行
查询的步骤
#### 1. **添加依赖**
在`pom.xml`中添加
Spring Data
Elasticsearch依赖：
```xml
<dependency>
<groupId>org.
springframework.
boot</groupId>
<artifactId>
spring-
boot-starter-data-
elasticsearch</artifactId>
</dependency>
```
#### 2. **配置
Elasticsearch连接**
在`application.properties`中配置ES地址：
```properties
spring.
elasticsearch.rest.uris=http://localhost:9200
# 若需要认证
spring.
elasticsearch.rest.username=your_username
spring.
elasticsearch.rest.password=your_password
```
#### 3. **创建实体类映射索引**
使用注解定义ES索引结构：
```
java
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 = "books") // 索引名称
public class Book {
@Id
private String id;
@Field(type = FieldType.Text, analyzer = "ik_max_word") //
使用中文分词器
private String title;
@Field(type = FieldType.Keyword) // 精确匹配字段
private String author;
@Field(type = FieldType.Integer)
private Integer publishYear;
// 构造方法/getter/setter
}
```
#### 4. **创建Repository接口**
继承`
ElasticsearchRepository`定义
查询方法：
```
java
import org.
springframework.data.
elasticsearch.repository.
ElasticsearchRepository;
import
java.util.List;
public interface BookRepository extends
ElasticsearchRepository<Book, String> {
// 1. 方法名自动推导
查询
List<Book> findByAuthor(String author);
// 2. 范围
查询
List<Book> findByPublishYearBetween(Integer startYear, Integer endYear);
// 3. 自定义DSL
查询
@Query("{\"match\": {\"title\": {\"query\": \"?0\"}}}")
List<Book> customSearch(String keyword);
}
```
#### 5. **复杂
查询示例（
使用RestHighLevelClient）**
对于更复杂的
查询，直接
使用ES客户端：
```
java
import org.
elasticsearch.action.search.SearchRequest;
import org.
elasticsearch.action.search.SearchResponse;
import org.
elasticsearch.client.RequestOptions;
import org.
elasticsearch.client.RestHighLevelClient;
import org.
elasticsearch.index.query.
QueryBuilders;
import org.
elasticsearch.search.builder.SearchSourceBuilder;
import org.
springframework.beans.factory.annotation.Autowired;
import
java.io.IOException;
public class BookService {
@Autowired
private RestHighLevelClient esClient;
public List<Book> searchBooks(String keyword, int minYear) throws IOException {
SearchRequest request = new SearchRequest("books");
SearchSourceBuilder sourceBuilder = new SearchSourceBuilder();
// 组合
查询：标题包含关键词 + 出版年份大于minYear
sourceBuilder.query(
QueryBuilders.boolQuery()
.must(
QueryBuilders.matchQuery("title", keyword))
.filter(
QueryBuilders.rangeQuery("publishYear").gte(minYear))
);
request.source(sourceBuilder);
SearchResponse response = esClient.search(request, RequestOptions.DEFAULT);
// 将搜索结果转换为Book列表（需实现解析逻辑）
return parseSearchResponse(response);
}
}
```
#### 6. **调用
查询（Controller示例）**
```
java
@RestController
@RequestMapping("/books")
public class BookController {
@Autowired
private BookRepository bookRepository;
@GetMapping("/search")
public List<Book> search(@RequestParam String author) {
return bookRepository.findByAuthor(author);
}
}
```
---
### 关键点解析
1. **依赖问题**
- 确保
Spring Boot版本与ES版本兼容（官方兼容矩阵：https://
spring.io/projects/
spring-data-
elasticsearch）
- 生产环境推荐
使用与ES服务端匹配的客户端版本
2. **映射机制**
- `@Document`定义索引配置（如分片数、副本数）
- `@Field`控制字段类型（Text支持分词，Keyword用于精确匹配）
3. **
查询类型选择**
- **简单
查询**：
使用方法名自动推导（如`findByTitleAndAuthor`）
- **中等复杂度**：
使用`@Query`注解写DSL
- **复杂
查询**：直接通过`RestHighLevelClient`
构建
4. **性能注意**
- 避免深度分页（
使用`search_after`代替`from/size`）
- 对文本字段
使用`keyword`类型进行精确匹配过滤
---
### 常见问题解决方案
**问题1：无法连接ES**
- 检查`
spring.
elasticsearch.rest.uris`格式（需包含`http://`）
-
使用`curl http://localhost:9200`验证ES服务状态
**问题2：字段映射错误**
- 删除旧索引让
Spring Boot自动创建新映射
- 手动更新映射：`PUT /books/_mapping { "properties": {...} }`
**问题3：中文分词失效**
- 安装IK分词器到ES插件目录
- 字段注解指定分词器：`@Field(type=FieldType.Text, analyzer="ik_max_word")`
---
本文介绍了Elasticsearch中进行全文检索的各种查询方式，包括全量查询、单个字段精确匹配、多字段匹配、模糊匹配、布尔复合查询、范围查询以及判空查询。同时，还展示了如何实现分页查询。内容详细且实用，适用于Elasticsearch的查询操作。
扫一扫
3万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
