实现 Spring Cloud & Apache Dubbo 互通

如果你在微服务开发过程中正面临以下一些业务场景需要解决，那么这篇文章可以帮到您：

您已经有一套基于 Dubbo 构建的微服务应用，这时你需要将部分服务通过 REST HTTP 的形式（非接口、方法模式）发布出去，供一些标准的 HTTP 端调用（如 Spring Cloud 客户端），整个过程最好是不用改代码，直接为写好的 Dubbo 服务加一些配置、注解就能实现。
您已经有一套基于 Spring Cloud 构建的微服务体系，而后又构建了一套 Dubbo 体系的微服务，你想两套体系共存，因此现在两边都需要调用到对方发布的服务。也就是 Dubbo 应用作为消费方要调用到 Spring Cloud 发布的 HTTP 接口，Dubbo 应用作为提供方还能发布 HTTP 接口给 Spring Cloud 调用
出于一些历史原因，你正规划从一个微服务体系迁移到另外一个微服务体系，前提条件是要保证中间过程的平滑迁移。

对于以上几个场景，我们都可以借助 Dubbo3 内置的 REST 编程范式支持实现，这让 Dubbo 既可以作为消费方调用 HTTP 接口的服务，又可以作为提供方对外发布 REST 风格的 HTTP 服务，同时整个编码过程支持业界常用的 REST 编程范式（如 JAX-RS、Spring MVC 等），因此可以做到基本不改动任何代码的情况下实现 Dubbo 与 Spring Cloud 体系的互相调用。

dubbo服务前置说明

Dubbo 最新依赖由 Apache 提供

xml 复制代码

<dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-bom</artifactId>
    <version>3.0.7</version>
    <type>pom</type>
    <scope>import</scope>
</dependency>
<!--如果使用的老版本的Dubbo，比如下面的这些依赖， 现在需要去掉啦 -->
 <!--        <dependency>
            <groupId>com.alibaba.spring.boot</groupId>
            <artifactId>dubbo-spring-boot-starter</artifactId>
            <version>2.0.0</version>
        </dependency>

        <dependency>
            <groupId>io.dubbo.springboot</groupId>
            <artifactId>spring-boot-starter-dubbo</artifactId>
            <version>1.0.0</version>
        </dependency> 
-->

dubbo 服务注册到 nacos

xml 复制代码

    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-registry-nacos</artifactId>
        <version>3.0.7</version>
            <!-- nacos 微服务版内的不一致去除,单独引入 -->
        <exclusions>
            <exclusion>
                <groupId>com.alibaba.nacos</groupId>
                <artifactId>nacos-client</artifactId>
            </exclusion>
        </exclusions>
        <type>pom</type>
    </dependency>
    <!-- dubbo starter 服务注册-->
    <dependency>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-client</artifactId>
        <version>${nacos-client-verson}</version>
    </dependency>

application.yml 的样例配置

yml 复制代码

dubbo:
  scan:
    base-packages: com.cloud.dubbo
  application:
    name:  ${spring.application.name}  #配置应用名是为了加以区分不同的服务提供者
  protocol:
    name: dubbo
    port: -1  # 端口设置为-1 是让dubbo自动在[20880, 65535]之间找一个可用的端口
  registry:# 注册中心
    address: nacos://${NACOS_SERVER:8848} # 在此配置nacos服务的IP地址及端口
    username: nacos
    password: nacos
    parameters:
      namespace: dubbo
      group: DUBBO_GROUP
  config-center: # 配置中心
    address: nacos://${NACOS_SERVER:8848}
    username: nacos
    password: nacos
    group: DUBBO_GROUP
  metadata-report: # 元数据中心
    address: nacos://${NACOS_SERVER:8848}
    username: nacos
    password: nacos
    group: DUBBO_GROUP

启动类添加注解如下

java 复制代码

    //服务注册
    @EnableDiscoveryClient
    //启动dubbo
    @EnableDubbo
    //启动Feign
    @EnableFeignClients
    @SpringBootApplication

feign 是同步IO 、阻塞模式的同步 RPC框架
dubbo 是基于Netty的非阻塞IO + Reactor 反应堆线程模型的异步RPC框架

示例一：Dubbo 调用 Spring Cloud

在已经有一套 Spring Cloud 微服务体系的情况下，演示如何使用 Dubbo 调用 Spring Cloud 服务（包含自动的地址发现与协议传输）。在注册中心方面，本示例使用 Nacos 作为注册中心，对于 Zookeeper、Consul 等两种体系都支持的注册中心同样适用。

设想你已经有一套 Spring Cloud 的微服务体系，现在我们将引入 Dubbo 框架，让 Dubbo 应用能够正常的调用到 Spring Cloud 发布的服务。

启动 Spring Cloud Server

示例中 Spring Cloud 应用的结构如下

应用配置文件如下：

yaml 复制代码

server:
  port: 8099
spring:
  application:
    name: spring-cloud-provider-for-dubbo
  cloud:
    nacos:
      serverAddr: 127.0.0.1:8848 #注册中心

以下是一个非常简单的 Controller 定义，发布了一个 /users/list/的 http 端点

less 复制代码

@RestController
@RequestMapping("/users")
public class UserController {
    @GetMapping("/list")
    public List<User> getUser() {
        return Collections.singletonList(new User(1L, "spring cloud server"));
    }
}

启动 SpringCloudApplication，通过 cURL 或浏览器访问 http://localhost:8099/users/list 可以测试应用启动成功。

使用 Dubbo Client 调用服务

Dubbo client 也是一个标准的 Dubbo 应用。

其中，一个比较关键的是如下接口定义（正常情况下，以下接口可以直接从原有的 Spring Cloud client 应用中原样拷贝过来即可，无需做任何修改）。

如果之前没有基于 OpenFeign 的 Spring Cloud 消费端应用，那么就需要自行定义一个接口，此时不一定要使用 OpenFeign 注解，使用 Spring MVC 标准注解即可。

kotlin 复制代码

@FeignClient(name = "spring-cloud-provider-for-dubbo")
public interface UserServiceFeign {
    @RequestMapping(value="/users/list", method = RequestMethod.GET, produces = "application/json")
    List<User> users();
}

通过 DubboReference 注解将 UserServiceFeign 接口注册为 Dubbo 服务

java 复制代码

@DubboReference
private UserServiceFeign userService;

接下来，我们就可以用 Dubbo 标准的方式对服务发起调用了

ini 复制代码

List<User> users = userService.users();

通过 DubboConsumerApplication 启动 Dubbo 应用，验证可以成功调用到 Spring Cloud 服务。

示例二：Spring Cloud 调用 Dubbo

在接下来的示例中，我们将展示如何将 Dubbo server 发布的服务开放给 Spring Cloud client 调用。

启动 Dubbo Server

Dubbo server 应用的代码结构非常简单，是一个典型的 Dubbo 应用。

相比于普通的 Dubbo 服务定义，我们要在接口上加上如下标准 Spring MVC 注解：

less 复制代码

@RestController
@RequestMapping("/users")
public interface UserService {
    @GetMapping(value = "/list")
    List<User> getUsers();
}

除了以上注解之外，其他服务发布等流程都一致，使用 DubboService 注解发布服务即可：

typescript 复制代码

@DubboService
public class UserServiceImpl implements UserService {
    @Override
    public List<User> getUsers() {
        return Collections.singletonList(new User(1L, "Dubbo provider!"));
    }
}

在服务配置上，特别注意我们需要将服务的协议配置为 rest protocol: rest，地址发现模式使用 register-mode: instance：

yaml 复制代码

dubbo:
  registry:
    address: nacos://127.0.0.1:8848
    register-mode: instance
  protocol:
    name: rest
    port: 8090

启动 Dubbo 应用，此时访问以下地址可以验证服务运行正常：http://localhost:8090/users/list

使用 Spring Cloud 调用 Dubbo

使用 OpenFeign 开发一个标准的 Spring Cloud 应用，即可调用以上发布的 Dubbo 服务。

其中，我们定义了一个 OpenFeign 接口，用于调用上面发布的 Dubbo rest 服务。

kotlin 复制代码

@FeignClient(name = "dubbo-provider-for-spring-cloud")
public interface UserServiceFeign {
    @RequestMapping(value = "/users/list", method = RequestMethod.GET)
    List<User> getUsers();
}

定义以下 controller 作为 OpenFeign 和 RestTemplate 测试入口。

kotlin 复制代码

public class UserController {

    private final RestTemplate restTemplate;
    private final UserServiceFeign userServiceFeign;

    public UserController(RestTemplate restTemplate,
                          UserServiceFeign userServiceFeign) {
        this.restTemplate = restTemplate;
        this.userServiceFeign = userServiceFeign;
    }

    @RequestMapping("/rest/test1")
    public String doRestAliveUsingEurekaAndRibbon() {
        String url = "http://dubbo-provider-for-spring-cloud/users/list";
        System.out.println("url: " + url);
        return restTemplate.getForObject(url, String.class);
    }

    @RequestMapping("/rest/test2")
    public List<User> doRestAliveUsingFeign() {
        return userServiceFeign.getUsers();
    }
}

根据以上 Controller 定义，我们可以分别访问以下地址进行验证：

OpenFeign 方式：http://localhost:8099/dubbo/rest/test1、
RestTemplate 方式：http://localhost:8099/dubbo/rest/test1

为 Dubbo Server 发布更多的服务

我们可以利用 Dubbo 的多协议发布机制，为一些服务配置多协议发布。接下来，我们就为上面提到的 Dubbo server 服务增加 dubbo tcp 协议发布，从而达到以下部署效果，让这个 Dubbo 应用同时服务 Dubbo 微服务体系和 Spring Cloud 微服务体系。

为了实现这个效果，我们只需要在配置中增加多协议配置即可：

yaml 复制代码

dubbo:
  protocols:
    - id: rest
      name: rest
      port: 8090
    - id: dubbo
      name: dubbo
      port: 20880

同时，服务注解中也配置为多协议发布

kotlin 复制代码

@DubboService(protocol="rest,dubbo")
public class UserServiceImpl implements UserService {}

这样，我们就成功的将 UserService 服务以 dubbo 和 rest 两种协议发布了出去（多端口多协议的方式），dubbo 协议为 Dubbo 体系服务，rest 协议为 Spring Cloud 体系服务。

注意： Dubbo 为多协议发布提供了单端口、多端口两种方式，这样的灵活性对于不同部署环境下的服务会有比较大的帮助。在确定您需要的多协议发布方式前，请提仔细阅读以下多协议配置文档。

总结

基于 Dubbo 的 rest 编程范式、多协议发布等特性，可以帮助你轻松的实现从 Dubbo 到 Spring Cloud 或者从 Spring Cloud 到 Dubbo 的平滑迁移（无改造成本），同时也可以实现 Dubbo 与 Spring Cloud 两套体系的共存。