ApiBoot v2.2.5版本无法兼容Hoxton.SR5的S
知识改变命运,撸码使我快乐,2020继续游走在开源界
点赞再看,养成习惯
给我来个Star吧,点击了解下基于SpringBoot的组件化接口服务落地解决方案
使用ApiBoot
最新发布的v2.2.5
版本整合SpringCloud Gateway
的Hoxton.SR5
版本时导致项目无法启动,控制台抛出的错误如下所示:
***************************
APPLICATION FAILED TO START
***************************
Description:
An attempt was made to call a method that does not exist. The attempt was made from the following location:
org.springframework.boot.web.embedded.netty.NettyReactiveWebServerFactory.lambda$createHttpServer$0(NettyReactiveWebServerFactory.java:158)
The following method did not exist:
reactor.netty.tcp.TcpServer.bindAddress(Ljava/util/function/Supplier;)Lreactor/netty/tcp/TcpServer;
The method's class, reactor.netty.tcp.TcpServer, is available from the following locations:
jar:file:/Users/yuqiyu/.m2/repository/io/projectreactor/netty/reactor-netty/0.9.6.RELEASE/reactor-netty-0.9.6.RELEASE.jar!/reactor/netty/tcp/TcpServer.class
The class hierarchy was loaded from the following locations:
reactor.netty.tcp.TcpServer: file:/Users/yuqiyu/.m2/repository/io/projectreactor/netty/reactor-netty/0.9.6.RELEASE/reactor-netty-0.9.6.RELEASE.jar
Action:
Correct the classpath of your application so that it contains a single, compatible version of reactor.netty.tcp.TcpServer
从控制台打印的错误信息我们可以发现这是版本不兼容的问题导致的,reactor-netty
作为SpringCloud Gateway
的重要组成部分之一,为什么会出现版本不兼容的问题呢?
reactor-bom
我们在构建项目时,SpringBoot
使用最新发布的v2.3.1
,在v2.3.1
版本的spring-boot-dependencies
固化版本依赖模块内定义reactor-bom
的依赖,如下所示:
<dependency>
<groupId>io.projectreactor</groupId>
<artifactId>reactor-bom</artifactId>
<version>${reactor-bom.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
${reactor-bom}
占位符对应的使用版本为Dysprosium-SR8
,通过查看reactor-bom
内定义的依赖列表发现了reactor-netty
的踪迹,而它对应的版本为v0.9.8
,如下所示:
<dependency>
<groupId>io.projectreactor.netty</groupId>
<artifactId>reactor-netty</artifactId>
<version>0.9.8.RELEASE</version>
</dependency>
那为什么我们在启动项目时控制台抛出了使用v0.9.6
版本的reactor-netty
导致不兼容的问题呢?
项目依赖的reactor-netty版本
查看idea
开发工具内项目的External Libraries
发现,项目编译时使用的reactor-netty
的版本确实是为v0.9.6
,如下图所示:
SpringCloud Gateway依赖的reactor-netty版本
Hoxton.SR5
版本的spring-cloud-dependencies
依赖内使用的spring-cloud-gateway
版本为2.2.3.RELEASE
,我们从GitHub
拉取spring-cloud-gateway
源码到本地,使用idea
工具打开项目并切换到2.2.x
分支后发现External Libraries
依赖列表内所使用的reactory-netty
版本为v0.9.7
,这是编译spring-cloud-gateway时所依赖的版本。
spring-cloud-gateway
仓库在GitHub
的地址为:git@github.com:spring-cloud/spring-cloud-gateway.git
问题分析
-
从上面的分析步骤中我们发现,
spring-cloud-gateway
编译时所使用的reactory-netty
版本为v0.9.7
,而v2.3.1
版本的SpringBoot
所使用的reactory-netty
版本为v0.9.8
,依赖的版本是支持向下兼容的,所以这样不会出现什么问题。 -
但是我们项目在编译时使用的
reactory-netty
版本却为v0.9.6
,版本肯定是不支持向上兼容的,所以才导致了项目启动时控制台打印的不兼容异常。
问题定位
在ApiBoot
的固化版本依赖api-boot-dependencies
内默认添加了SpringCloud
的依赖,为了方便项目集成SpringCloud
时使用组件,不过这也导致了这个问题的发生。
v2.2.5
版本的ApiBoot
内集成的SpringCloud
版本为Hoxton.RELEASE
,要比Hoxton.SR5
版本发布的更早,它所使用的reactory-netty
依赖版本为v0.9.6
。
解决问题
既然找到了问题,对症下药,解决起来就容易了,我们只需要把项目中所依赖的reactory-netty
版本修改为v0.9.6
以上版本即可,在项目的pom.xml
内添加如下依赖:
<dependencyManagement>
<!--省略其他依赖-->
<dependencies>
<dependency>
<groupId>io.projectreactor.netty</groupId>
<artifactId>reactor-netty</artifactId>
<version>0.9.8</version>
</dependency>
</dependencies>
</dependencyManagement>