当前位置：首页 > news >正文

Spring Cloud Alibaba 实战：轻松实现 Nacos 服务发现与动态配置管理

news 来源：原创 2025/6/8 12:47:03

1. Nacos 介绍

1.1 什么是 Nacos？

Nacos（Naming and Configuration Service）是阿里巴巴开源的一个服务注册中心和配置管理中心。它支持动态服务发现、配置管理和服务治理，适用于微服务架构，尤其是基于 Spring Cloud 和 Kubernetes 的应用。

1.2 Nacos 主要功能

服务发现与注册：提供类似 Eureka 的服务注册与发现功能。
动态配置管理：可替代 Spring Cloud Config，实现配置的集中管理。
服务健康检查：通过心跳检测服务健康状态。
DNS 解析：支持基于 DNS 的服务发现方式。
多环境、多租户管理。

2. 环境准备

JDK：确保你安装了 JDK 8 或以上版本。
Spring Boot：版本建议使用 2.3 或以上。
Nacos 服务：确保你已经下载并启动了 Nacos 服务器，可以使用 Nacos GitHub 或官方网站来下载和启动。

2.1 下载并启动 Nacos

访问 Nacos 官网（Nacos 官方下载页面）下载最新版本的 Nacos。
解压文件后，进入解压目录，使用以下命令启动 Nacos 服务（默认启动 Nacos 在单机模式下）：
```
sh startup.sh -m standalone
```
这时，Nacos 服务将会启动，并在 http://localhost:8848/nacos 上提供访问。
访问控制台：打开浏览器访问 http://localhost:8848/nacos，使用默认的账号密码登录：
- 用户名：nacos
- 密码：nacos

3. Spring Cloud Alibaba Nacos 配置

3.1 引入依赖

在 Spring Boot 项目中添加必要的依赖。确保你的 pom.xml 文件中包含以下内容：

<dependencies>
    <!-- Spring Boot Web Starter -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <!-- Spring Cloud Alibaba Nacos Discovery -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
    </dependency>

    <!-- Spring Cloud Alibaba Nacos Config -->
    <dependency>
        <groupId>com.alibaba.cloud</groupId>
        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    </dependency>

    <!-- Spring Cloud OpenFeign (Optional, for service consumer) -->
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-openfeign</artifactId>
    </dependency>

    <!-- Spring Boot Actuator (Optional, for monitoring) -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
</dependencies>

这里：

spring-cloud-starter-alibaba-nacos-discovery 是 Spring Cloud Nacos 服务注册与发现模块。
spring-cloud-starter-alibaba-nacos-config 用于配置管理。
spring-cloud-starter-openfeign 用于服务消费者时的 Feign 客户端调用（可选）。

3.2 配置 Nacos 地址

在 application.properties 或 application.yml 中配置 Nacos 的地址和应用信息：

# 应用名称，用于服务注册
spring.application.name=demo-service

# Nacos 服务注册中心的地址
spring.cloud.nacos.discovery.server-addr=localhost:8848

# 配置管理服务的地址
spring.cloud.nacos.config.server-addr=localhost:8848

# 配置的文件类型
spring.cloud.nacos.config.file-extension=properties

这些配置项的解释：

spring.application.name：Spring Boot 应用的名称，用于在 Nacos 注册。
spring.cloud.nacos.discovery.server-addr：Nacos 服务发现模块的地址。
spring.cloud.nacos.config.server-addr：Nacos 配置中心的地址，用于配置管理。

4. 服务注册与发现

4.1 创建服务提供者

我们首先创建一个服务提供者，这个服务会在启动时注册到 Nacos 服务注册中心。

服务消费者可以通过 Nacos 来发现并调用服务提供者。

当你启动 DemoServiceApplication 应用时，服务会自动注册到 Nacos，您可以通过访问 http://localhost:8080/hello 来测试服务。

4.2 创建服务消费者

创建 Spring Boot 应用 DemoServiceApplication：

package com.example.demo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@EnableDiscoveryClient  // 启用服务发现
public class DemoServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoServiceApplication.class, args);
    }
}

创建一个简单的控制器 HelloController：

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Nacos!";
    }
}

在上述代码中：

@EnableDiscoveryClient 注解使得 Spring Boot 应用能注册到 Nacos 注册中心。
/hello 接口用于向消费者提供服务。

当你启动 DemoServiceApplication 应用时，服务会自动注册到 Nacos，您可以通过访问 http://localhost:8080/hello 来测试服务。

服务消费者可以通过 Nacos 来发现并调用服务提供者。

创建服务消费者应用 DemoConsumerApplication：

package com.example.consumer;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;
import org.springframework.cloud.openfeign.EnableFeignClients;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@EnableDiscoveryClient  // 启用服务发现
@EnableFeignClients      // 启用 Feign 客户端
public class DemoConsumerApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoConsumerApplication.class, args);
    }
}

创建 Feign 客户端接口 HelloFeignClient

package com.example.consumer;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;

@FeignClient(name = "demo-service")  // 与服务提供者的应用名匹配
public interface HelloFeignClient {

    @GetMapping("/hello")
    String sayHello();
}

3.创建控制器 HelloController 用于消费服务：

package com.example.consumer;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @Autowired
    private HelloFeignClient helloFeignClient;

    @GetMapping("/consume")
    public String consumeService() {
        return helloFeignClient.sayHello();  // 使用 Feign 调用服务提供者
    }
}

@FeignClient(name = "demo-service") 中 name 是服务提供者的应用名称。Fein 会自动从 Nacos 获取服务实例并进行调用。
/consume 接口通过 Feign 客户端调用服务提供者的 /hello 接口。

5. 配置管理

Nacos 还可以作为配置中心，动态管理应用配置。

5.1 上传配置到 Nacos

打开 Nacos 控制台，选择左侧的 "配置管理" -> "配置列表" -> "新增配置"。
配置文件内容如下（假设文件类型为 .properties）：
```
# application.properties
demo.property=HelloFromNacos
```
在 "Data ID" 中填写 application.properties，选择 Group 为 DEFAULT_GROUP，点击发布

在 Spring Boot 中，可以通过 @Value 注解直接获取配置项：

package com.example.demo;

import org.springframework.beans.factory.annotation.Value;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class ConfigController {

    @Value("${demo.property}")
    private String demoProperty;

    @GetMapping("/config")
    public String getConfig() {
        return demoProperty;  // 返回从 Nacos 获取的配置
    }
}

这里：

@Value("${demo.property}") 读取 Nacos 中配置的 demo.property 属性。

5.2动态刷新配置

当 Nacos 中的配置发生变化时，Spring Cloud Alibaba Nacos 支持动态刷新配置。为了实现这个功能，我们可以使用 @RefreshScope 注解。

在 ConfigController 中：

import org.springframework.beans.factory.annotation.Value;
import org.springframework.cloud.context.config.annotation.RefreshScope;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RefreshScope
@RestController
public class ConfigController {

    @Value("${demo.property}")
    private String demoProperty;

    @GetMapping("/config")
    public String getConfig() {
        return demoProperty;
    }
}