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

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

news 2025/8/27 1:40:10

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 {@Autowiredprivate 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;}
}