dubbo2升级到dubbo3实践

dubbo当前版本 2.7.3 期望升级到 3.0.11。

升级过程

maven依赖变更

<dependency>
	<groupId>org.apache.dubbo</groupId>
	<artifactId>dubbo</artifactId>
	<version>3.0.11</version>
</dependency>
<dependency>
	<groupId>org.apache.dubbo</groupId>
	<artifactId>dubbo-spring-boot-starter</artifactId>
	<version>3.0.11</version>
</dependency>

dubbo2 升级到dubbo3兼容性配置

服务端

dubbo.application.register-mode 服务端提供者服务的注册模式可选值有

instance 只注册实例应用级
all 接口级+应用级均注册
interface 只注册接口级

升级到3.x之后在不修改配置的情况下默认是 all配置开启接口级+应用级注册

消费端/客户端

服务有注册模式那么消费端肯定也有服务订阅发现模式设置

dubbo.application.service-discovery.migration 消费端订阅模式可选值有

APPLICATION_FIRST 双订阅即接口模式/应用级模式智能决策一般用于2.7.x与3.x 升级中共存阶段也是3.x版本默认的订阅模式
FORCE_APPLICATION 仅应用级订阅模式
FORCE_INTERFACE 仅接口级订阅模式

关于兼容这一步如果项目升级的时候没有用户使用不做兼容性升级也没问题，这里主要是介绍保障逐步把2.7.x版本升级到3.x 而不是全部停机后重新部署。

红色虚线框部分是3.x版本的部分升级后实例，左边是原始的2.7.x版本实例。大概操作流程如下

1、逐步把部分Provider替换为3.x 服务端注册模式为all应用级+接口级，这样2.7.x的消费端也能够根据接口服务发现

2、逐步把部分Consumer替换为3.x 消费订阅模式为APPLICATION_FIRST双订阅模式

3、观察3.x版本服务端与消费端情况，如果异常就回滚到2.7.x。没啥问题的话就可以逐步全部切换到3.x版本

4、到了这一步说明当前所有实例均为3.x版本，下次再更新的时候就把服务端注册模式设置为instance ，消费端订阅模式设置为 FORCE_APPLICATION 就完美切换到3.x版本并且是应用级服务发现。

踩坑问题

3.0.11其实也没有太多问题好多问题都在之前版本就修复了，主要就是由于自身项目编码问题导致进了一个坑

由于原来项目编码不是很规范，在本地服务的接口中用到@Autowired、本服务内部调用有的又用到了 @DubboReference 这种情况启动的时候就会报错，在2.7.x却不报错。这是因为3.x把Reference的bean代理也注入到spring容器中去了。本身的@DubboService Bean也会注册到Spring容器中去。就会导致出现2个类型一样的springBean，导致使用Autowired，由于属性name不规范的时候就会报错。

Field demoService in org.apache.dubbo.springboot.demo.provider.DemoService2 required a single bean, but 2 were found:
- demoServiceImpl: defined in file [D:\opensource\dubbo-samples\1-basic\dubbo-samples-spring-boot\dubbo-samples-spring-boot-provider\target\classes\org\apache\dubbo\springboot\demo\provider\DemoServiceImpl.class]
- demoServiceRemote: defined in null

3.x主要新特性

服务注册与发现改版由接口级别改为应用级
云原生更好的支持如native image，dubbo proxyless Mesh，
可视化的dubbo-admin服务治理能力
全新通信协议Triple 让跨语言RPC迈了一大步，支持点对点调用、stream 流式调用。写proto IDL 文件可生成各类客户端代码，完全兼容grpc 让java与go`成为后端深度合作伙伴

3.x小版本更新

3.0.x升级到3.1.x

变动不大就只是针对nacos的group进行了对齐。如果配置中填写的nacos的地址带了group参数的话，需要客户端和服务端保持一致的group。

当然也可以强制去掉group分组隔离功能 dubbo.nacos-service-discovery.use-default-group=false 全局属性值忽略该功能

3.1.x升级到3.2.x

最大的变更是默认序列化的变了，dubbo协议默认序列化由hessian2变更为 fastjson2，原因就是fastjson2性能更高也能兼容hessian2 也支持jdk17 和Native 。

triple协议支持自定义异常回传。