2.x 升级至 3.x 操作指南

快速了解 Dubbo 3 的升级步骤与兼容性

升级

无需改动任何代码,直接升级到 Dubbo 3.0。

在 3.0 版本的设计与开发之初,我们就定下了兼容老版本 Dubbo 用户(2.5、2.6、2.7)的目标。因此,往 3.0 版本的升级过程将会是完全透明的,用户无需做任何业务改造,升级 3.x 后的框架行为将保持与 2.x 版本完全一致。

  1. <dependency>
  2. <groupId>org.apache.dubbo</groupId>
  3. <artifactId>dubbo</artifactId>
  4. <version>3.0.10</version>
  5. </dependency>

但也要注意,透明升级仅仅是通往 3.0 的第一步,因为 “框架行为保持一致” 也就意味着用户将无法体验到 3.0 的新特性。如果要启用 3.0 的带来的新特性,用户则需要进行一定的改造,我们称这个过程为迁移,这是一个按需开启的过程。

老用户

对老用户而言,有两条不同的迁移路径:

  • 分两步走,先以兼容模式推动业务升级到 3.0 版本(无需改造),之后在某些时机按需启用新特性(按需改造);
  • 升级与迁移同步完成,在业务升级到 3.0 版本的同时,完成改造并启用新特性;

Dubbo 3.0 新特性

Dubbo 3.0 提供的新特性包括:

最后修改 December 16, 2022: Fix check (#1736) (97972c1)