Upgrades and Compatibility on Apache Dubbo

Upgrading from Dubbo2 to Dubbo3 (covering versions such as 2.5.x, 2.6.x, 2.7.x)

Mon, 01 Jan 0001 00:00:00 +0000

Overall, the core capabilities after upgrading from Dubbo2 to Dubbo3 are compatible, and for over 90% of regular users (referring to users who have not made deep SPI extensions or source customizations), upgrading can be quite simple.

Upgrading from 2.7.x to Dubbo3

Step 1: Upgrade Core Dependencies

First, add the BOM dependency management in the application:

<dependencyManagement>
 <dependencies>
 <dependency>
 <groupId>org.apache.dubbo</groupId>
 <artifactId>dubbo-dependencies-bom</artifactId>
 <version>3.3.0</version>
 <type>pom</type>
 <scope>import</scope>
 </dependency>
 </dependencies>
</dependencyManagement>

If you previously used the org.apache.dubbo:dubbo dependency, please upgrade to the following version (if there are other Dubbo submodule dependencies in the project, upgrade their versions as well):

Upgrade to Triple Protocol

Mon, 01 Jan 0001 00:00:00 +0000

Note

The content of this document is not mandatory for upgrading Dubbo3. You can simply upgrade the framework and continue using the Dubbo communication protocol.
If you are a new Dubbo user, it is highly recommended to directly use the Triple protocol.

This document is suitable for users whose services are already running on the Dubbo protocol. Please first refer to the previous document How to Upgrade from Dubbo2 to Dubbo3 to complete the framework version upgrade, and then follow these steps for a smooth migration to the Triple protocol with minimal changes.

Upgrade to Application-Level Service Discovery

Mon, 01 Jan 0001 00:00:00 +0000

Note

The contents of this document are not mandatory for upgrading to Dubbo 3. You can absolutely just upgrade the framework and use the default behavior of the framework’s service discovery.
This document is more suitable for old Dubbo 2 users to understand the transition process and working principle of the service discovery model in the framework after upgrading to Dubbo 3. New users should directly configure to enable application-level service discovery.

For old Dubbo 2 users, there are two choices when upgrading to Dubbo 3, and the only consideration for the decision is performance.