Spring Boot 整合 Dubbo3 + Nacos 2.4.0【进阶】+ 踩坑记录

Spring Boot 整合 Dubbo3 + Nacos 2.4.0【进阶】+ 踩坑记录

在微服务架构中，服务治理和服务发现是非常重要的环节。随着分布式系统的日益复杂，Dubbo3 和 Nacos 作为服务框架和服务发现的解决方案，逐渐被越来越多的开发者接受。本文将分享 Spring Boot 整合 Dubbo3 和 Nacos 2.4.0 的经验和一些踩坑记录。

1. 环境准备

在开始之前，你需要确保你的开发环境中已经安装了以下组件：

• JDK 1.8 或以上
• Maven
• Nacos 2.4.0 （可以本地运行，也可以使用云端）
• Spring Boot 2.6.x（或者其他兼容版本）

2. 项目搭建

首先，通过 Spring Initializr 创建一个 Spring Boot 项目，选择依赖项包括 Spring Web 和 Spring Boot DevTools。之后在 pom.xml 中添加 Dubbo 和 Nacos 的依赖：

<dependencies>
    <dependency>
        <groupId>org.apache.dubbo</groupId>
        <artifactId>dubbo-spring-boot-starter</artifactId>
        <version>3.1.0</version>
    </dependency>
    <dependency>
        <groupId>com.alibaba.nacos</groupId>
        <artifactId>nacos-spring-boot-starter</artifactId>
        <version>2.4.0</version>
    </dependency>
</dependencies>

3. 配置文件

在 application.yml 中，添加 Nacos 和 Dubbo 的相关配置：

spring:
  application:
    name: demo-provider
  cloud:
    nacos:
      discovery:
        server-addr: localhost:8848 # Nacos Server 地址
      config:
        server-addr: localhost:8848
        file-extension: yaml # 配置文件格式

dubbo:
  application:
    name: demo-provider
  registry:
    address: nacos://localhost:8848 # 使用 Nacos 作为注册中心
  protocol:
    name: dubbo
    port: 20880 # Dubbo 服务端口

4. 编写服务提供者

接下来，我们编写一个 Dubbo 服务接口及其实现：

// 接口
public interface GreetingService {
    String sayHello(String name);
}

// 实现
@Service
public class GreetingServiceImpl implements GreetingService {
    @Override
    public String sayHello(String name) {
        return "Hello, " + name;
    }
}

5. Service 注解

在实现类上添加 Dubbo 的注解，进行服务暴露：

import org.apache.dubbo.config.annotation.DubboService;

@DubboService
@Service
public class GreetingServiceImpl implements GreetingService {
    @Override
    public String sayHello(String name) {
        return "Hello, " + name;
    }
}

6. 启动 Nacos 和服务

确保 Nacos 服务器正在运行。然后启动 Spring Boot 项目，这时可以在 Nacos 的控制台上看到 demo-provider 服务已成功注册。

7. 踩坑记录

• Nacos 未正确连接：检查 server-addr 配置是否正确。确保 Nacos 服务器端口和地址无误。

• Dubbo 接口未暴露：检查 @DubboService 注解是否存在，并且服务接口是否被 Spring 扫描到。

• 客户端调用失败：在服务消费者中配置相同的 Nacos 地址，确保依赖和配置一致。

• 版本兼容性问题：在不同版本的 Dubbo 和 Nacos 中，有些配置可能会变动，需参考官方文档确认。

8. 结语

通过本文的步骤，你应当能够顺利搭建一个基本的 Spring Boot + Dubbo3 + Nacos 2.4.0 的微服务应用。务必注意踩坑记录中的细节，让你的开发过程更加顺利。希望这篇文章能够对你有所帮助，继续探索微服务的世界吧！