Springboot es包版本异常解决方案

下面是“Springboot es包版本异常解决方案”的完整攻略，包含以下几部分内容：

1. 问题描述
2. 解决方案
3. 示例说明

问题描述

使用 Spring Boot 时，如果要使用 Elasticsearch，一般会使用 Spring Data Elasticsearch（spring-boot-starter-data-elasticsearch），其中包含了 Elasticsearch 的 Java 客户端 TransportClient。但是，在某些情况下，我们会遇到版本不兼容的问题，从而导致无法正常使用 Elasticsearch。

例如，在使用 Spring Boot 2.4.1 和 spring-boot-starter-data-elasticsearch 2.4.1 版本的情况下，可能会遇到以下异常：

java.lang.NoSuchMethodError: org.elasticsearch.client.transport.TransportClient ...`

这个问题的本质是由于 Elasticsearch 6.x 中的 TransportClient 已经被废弃，而 Spring Boot 2.4.x 默认使用了 Elasticsearch 6.x，因此无法正常使用 TransportClient。

解决方案

要解决这个问题，需要使用 Elasticsearch 的 Java 客户端 RestClient，这是 Elasticsearch 7.x 推荐的方式。RestClient 在 Elasticsearch 6.x 和 7.x 中都是可用的，可以保证版本兼容性。

具体来说，可以使用以下的依赖（示例中使用的是 Maven）：

<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level-client</artifactId>
    <version>7.9.3</version>
</dependency>

除了依赖之外，还需要进行一些配置。可以在 application.yml（或者 application.properties）中添加以下配置：

spring.elasticsearch.rest.uris=localhost:9200

这里的配置是告诉 Spring Boot，Elasticsearch 的地址是 localhost:9200，也可以配置其他的地址。

最后，在使用 Elasticsearch 进行操作的时候，需要使用 RestClient 来构建连接，例如：

@Autowired
private RestHighLevelClient restHighLevelClient;

SearchRequest searchRequest = new SearchRequest("index-name");
SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
searchSourceBuilder.query(QueryBuilders.matchAllQuery());
searchRequest.source(searchSourceBuilder);

SearchResponse searchResponse = restHighLevelClient.search(searchRequest, RequestOptions.DEFAULT);

示例说明

下面以实际的代码实例来说明如何使用 RestClient 来操作 Elasticsearch。

首先，需要新建一个 Spring Boot 应用，并添加以下依赖（以 Maven 为例）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

<dependency>
    <groupId>org.elasticsearch.client</groupId>
    <artifactId>elasticsearch-rest-high-level-client</artifactId>
    <version>7.9.3</version>
</dependency>

然后，在 application.yml 中添加以下配置：

spring.elasticsearch.rest.uris=localhost:9200

接下来，编写一个简单的控制器来演示如何使用 Elasticsearch：

@RestController
public class TestController {

    @Autowired
    private RestHighLevelClient restHighLevelClient;

    @GetMapping("/search")
    public String search() throws IOException {
        SearchRequest searchRequest = new SearchRequest("my-index");
        SearchSourceBuilder searchSourceBuilder = new SearchSourceBuilder();
        searchSourceBuilder.query(QueryBuilders.matchAllQuery());
        searchRequest.source(searchSourceBuilder);

        SearchResponse searchResponse = restHighLevelClient.search(searchRequest, RequestOptions.DEFAULT);

        return Arrays.toString(searchResponse.getHits().getHits());
    }
}

这个控制器会查询名为 my-index 的索引中的所有数据，并返回结果。注意，这里的参数 RequestOptions.DEFAULT 是 RequestOptions 提供的默认参数，可以根据实际情况进行修改。

最后，启动应用，访问 http://localhost:8080/search，就可以得到 Elasticsearch 返回的结果了。