ApiBoot v2.2.5版本无法兼容Hoxton.SR5的SpringCloud Gateway

使用ApiBoot最新发布的v2.2.5版本整合SpringCloud GatewayHoxton.SR5版本时导致项目无法启动,控制台抛出的错误如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
***************************
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的依赖,如下所示:

1
2
3
4
5
6
7
<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,如下所示:

1
2
3
4
5
<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

问题分析

  1. 从上面的分析步骤中我们发现,spring-cloud-gateway编译时所使用的reactory-netty版本为v0.9.7,而v2.3.1版本的SpringBoot所使用的reactory-netty版本为v0.9.8,依赖的版本是支持向下兼容的,所以这样不会出现什么问题。

  2. 但是我们项目在编译时使用的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内添加如下依赖:

1
2
3
4
5
6
7
8
9
10
<dependencyManagement>
<!--省略其他依赖-->
<dependencies>
<dependency>
<groupId>io.projectreactor.netty</groupId>
<artifactId>reactor-netty</artifactId>
<version>0.9.8</version>
</dependency>
</dependencies>
</dependencyManagement>

SpringCloud基础教程专题

被访问0


关于专题

SpringCloud目前有两个主流的体系:原生体系Alibaba体系,本专题会涵盖这两个主流体系的核心技术讲解文章,提供给大家一整套的微服务架构搭建以及部署方案

自定义你自己的Eureka管理界面

Eureka服务端的界面是可以自定义的,而且方式比较简单,下面我们来看下修改方式。

长期免费开放一台Nacos Server服务

恒宇少年准备着手更新SpringCloud Alibaba系列文章教程,为了方便大家的学习特意免费长期开放了一台Nacos Server,可以用来当做服务注册中心使用,也可以当做配置中心使用。

长期免费开放一台Eureka Server服务

恒宇少年为了大家学习SpringCloud方便,特意给大家提供了一个在线开放的Eureka Server服务,大家可以直接在学习使用服务注册时配置使用开放的Eureka Server进行服务注册。

SpringCloud与Seata分布式事务初体验

在本篇文章中我们在SpringCloud环境下通过使用Seata来模拟用户购买商品时由于用户余额不足导致本次订单提交失败,来验证下在MySQL数据库内事务是否会回滚

阿里巴巴分布式事务利器Seata环境准备

阿里巴巴自从跟SpringCloud共同发起创建微服务开源社区时,开启了SpringCloud Alibaba分支,而且在生态内提供了一款适用于分布式应用程序(DubboSpringCloud等)的事务框架Seata,该框架经过多个大版本的发布,已经支持MySQLOracle这两种数据库事务回滚(Rollback)以及提交(Commit)控制,每次发版都会修复一些用户反馈的Issue以及添加一些新特性。

搭建Eureka服务注册中心

Eureka服务注册中心是netflix开源组织提供的一个服务高可用的解决方案,在前端时间一直在疯传的2.0开源流产的问题,其实并不影响我们的使用,netflix只不过是不再维护2.0分支的开源代码,所以做出了免责声明,不过对于我们使用者来说确实比较担心这一点,还有不少人更换服务注册中心,比如:zookeeperconsul

SpringCloud Gateway整合Eureka转发服务请求

在上一篇文章SpringCloud Gateway路由转发规则中我们讲解了SpringCloud Gateway内部提供的断言、谓语,让我们可以组合更精确的业务场景进行请求,既然SpringCloud GateWay担任了网关的角色,在之前Zuul可以通过服务名进行自动转发,SpringCloud Gateway是否可以实现自动转发呢?

SpringCloud Gateway路由转发规则

Spring在因Netflix开源流产事件后,在不断的更换Netflix相关的组件,比如:EurekaZuulFeignRibbon等,Zuul的替代产品就是SpringCloud Gateway,这是Spring团队研发的网关组件,可以实现限流、安全认证、支持长连接等新特性。

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×