Dubbo 整合 Nacos 2.x

最新推荐文章于 2025-06-19 13:41:32 发布

原创最新推荐文章于 2025-06-19 13:41:32 发布 · 582 阅读

5 ·

CC 4.0 BY-SA版权

文章标签：

#dubbo

微服务组件配置教程专栏收录该内容

12 篇文章

订阅专栏

本文介绍了如何在SpringBoot项目中整合ApacheDubbo，包括依赖管理、配置YAML文件、启用注解、实体类序列化以及发布和服务的使用示例。同时提供了常见问题解答（FAQ），解决启动时可能出现的错误。

一、整合流程

引入依赖（注意依赖的版本兼容关系，可查询官网）

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>2.7.6</version>
</parent>

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.alibaba.cloud</groupId>
      <artifactId>spring-cloud-alibaba-dependencies</artifactId>
      <version>2021.0.5.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <!--dubbo starter-->
  <dependency>
    <groupId>org.apache.dubbo</groupId>
    <artifactId>dubbo-spring-boot-starter</artifactId>
    <version>3.2.10</version>
  </dependency>

  <!--注册中心-->
  <dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  </dependency>

  <!--配置中心-->
  <dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
  </dependency>
</dependencies>

配置 yml 文件

dubbo:
  application:
    # 引用 pom 文件中的项目名称
    name: @project.artifactId@
    qos-enable: true
    # 如果在同一台机器上启动多个服务，最好配置一下，否则大概率端口冲突
    qos-port: 3333
  protocol:
    name: dubbo
    port: -1
  registry:
    # 前面有 nacos 协议
    address: nacos://localhost:8848 
    # 这两行代码是为了解决启动错误，具体原因详见下面FAQ
    use-as-metadata-center: false 
    use-as-config-center: false

开启 Dubbo 的启用注解

@SpringBootApplication
// 这个注解必须开启
@EnableDubbo
public class OrderApp {
    public static void main(String[] args) {
        SpringApplication.run(OrderApp.class, args);
    }
}

Dubbo 中的实体类必须要序列化（即实体类需要实现 Serializable 接口）

二、使用案例

发布服务

// 使用下面注解发布服务
@DubboService
public class UserServiceImpl implements UserService {

    @Resource
    private UserMapper userMapper;

    @Override
    public List<Account> getAll() {
        return userMapper.findAll();
    }
}

拉取服务

@Service
public class OrderServiceImpl implements OrderService {

    // 下面的注解拉取服务
    @DubboReference
    private UserService userService;

    @Override
    public void addOrder() {
        // ...
        userService.getAll();
    }
}

三、FAQ

上述流程较为简单，如果有些配置项不太清楚，可求助搜索引擎哦
use-as-metadata-center 与 use-as-config-center 配置是为了解决启动时的 java.lang.RuntimeException: publish nacos metadata failed 错误，出现错误的原因可参考 Github