Elasticsearch 升级 7.x 版本后，我感觉掉坑里了！

最近想把我的 mall 项目升级下，支持 SpringBoot 2.3.0 版本。升级过程中发现需要升级 Elasticsearch 到 7.x 版本，学习过我的 mall 项目的朋友应该知道，我用的 Elasticsearch 是 6.x 版本，升级到 7.x 以后 ElasticsearchTemplate 都不让用了。本文记录了 Elasticsearch 从 6.x 升级到 7.x 所遇到的一些问题，给大家排排坑！

#版本选择

既然我们要升级到Elasticsearch7.x版本，首先要选择合适的版本。如何选择合适的版本，这里有个小技巧分享给大家。

首先我们可以在pom.xml中修改SpringBoot依赖的版本为2.3.0；

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.3.0.RELEASE</version>
    <relativePath/> <!-- lookup parent from repository -->
</parent>

然后在项目的External Libraries中搜索elasticsearch，可以发现elasticsearch-7.6.2.jar这个依赖；

然后打开其中的MANIFEST.MF文件，通过jar包中的X-Compile-Elasticsearch-Version属性，我们可以找到兼容的Elasticsearch版本号为7.6.2；

之前还有试过两个版本6.2.2版本和7.4.0版本，发现与SpringBoot 2.3.0 都有兼容性问题，所以选择合适的版本很重要！
还有一点值得注意的是，如果你使用了中文分词器（IK Analysis），也要选择对应的版本7.6.2，对于使用Kibana和Logstash也是如此。

#遇到的问题

选择好了合适的Elasticsearch版本后，接下来我们来讲讲升级版本遇到的问题了！

在application.yml中，原来我们用来配置Elasticsearch访问路径和集群名称的配置已经不建议使用了；

取而代之的是直接配置Elasticsearch的rest访问地址；

spring:
  elasticsearch:
    rest:
      uris: http://localhost:9200

其实最大的问题还是ElasticsearchTemplate已经过时了，不建议使用了，之前复杂的数据操作用到了它；

推荐使用的是ElasticsearchRestTemplate，这大概就是修改application.yml中那两个配置的原因了，修改为使用ElasticsearchRestTemplate后，我们可以发现原来ElasticsearchTemplate的query()方法已经没有了；

可以使用ElasticsearchRestTemplate的search()方法来代替，原来的复杂查询将有以下改进；

// 使用ElasticsearchTemplate进行复杂查询
return elasticsearchTemplate.query(searchQuery, response -> {
    LOGGER.info("DSL:{}",searchQuery.getQuery().toString());
    return convertProductRelatedInfo(response);
});
// 使用ElasticsearchRestTemplate进行复杂查询
SearchHits<EsProduct> searchHits = elasticsearchRestTemplate.search(searchQuery, EsProduct.class);
return convertProductRelatedInfo(searchHits);

我们转换聚合结果对象的方法convertProductRelatedInfo也改进下，只是改变了方法参数类型而已；

//改进前
private EsProductRelatedInfo convertProductRelatedInfo(SearchResponse response) {
    //省略方法体代码...
}
//改进后
private EsProductRelatedInfo convertProductRelatedInfo(SearchHits<EsProduct> response) {
    //省略方法体代码...
}

如果你觉得这样就行了，那你调用下接口就会发现，报了个类型转换异常；

2020-07-21 14:40:48.154 ERROR 11616 --- [nio-8080-exec-3] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; 
nested exception is java.lang.ClassCastException: org.elasticsearch.search.aggregations.bucket.nested.ParsedNested cannot be cast to org.elasticsearch.search.aggregations.bucket.nested.InternalNested] with root cause

java.lang.ClassCastException: org.elasticsearch.search.aggregations.bucket.nested.ParsedNested cannot be cast to org.elasticsearch.search.aggregations.bucket.nested.InternalNested
	at com.macro.mall.tiny.service.impl.EsProductServiceImpl.convertProductRelatedInfo(EsProductServiceImpl.java:254) ~[classes/:na]
	at com.macro.mall.tiny.service.impl.EsProductServiceImpl.searchRelatedInfo(EsProductServiceImpl.java:229) ~[classes/:na]
	at com.macro.mall.tiny.controller.EsProductController.searchRelatedInfo(EsProductController.java:104) ~[classes/:na]

我们对该问题进行修复，主要就是原来的Terms对象都被改为了ParsedTerms相关对象，比如说StringTerms被改为了ParsedStringTerms对象，具体对比如下；

我们还发现原来使用的ElasticsearchRepository的search()方法也过时了，不建议使用了，我们以前用它做了一些复杂查询；

我们可以改用ElasticsearchRestTemplate的search()方法来实现，具体实现对比如下；

// ElasticsearchRepository实现复杂搜索
return productRepository.search(searchQuery)
// ElasticsearchRestTemplate实现复杂搜索
SearchHits<EsProduct> searchHits = elasticsearchRestTemplate.search(searchQuery, EsProduct.class);
if(searchHits.getTotalHits()<=0){
    return new PageImpl<>(null,pageable,0);
}
List<EsProduct> searchProductList = searchHits.stream().map(SearchHit::getContent).collect(Collectors.toList());
return new PageImpl<>(searchProductList,pageable,searchHits.getTotalHits());

#总结

Elasticsearch从6.x升级到7.x改动还真不是一般的大，ElasticsearchTemplate不建议使用了，改为使用ElasticsearchRestTemplate，ElasticsearchRepository实现复杂查询的方法也不建议使用了。从此我们简单的数据操作可以使用ElasticsearchRepository，而复杂的数据操作只能使用ElasticsearchRestTemplate了。

#项目源码地址

https://github.com/macrozheng/mall-learning/tree/master/mall-tiny-elasticsearch