Spring Cloud 集成 Nacos，全面的配置中心与服务发现解决方案

大家好，我是小悟。

一、Nacos 详细介绍

1.1 什么是 Nacos

Nacos（Dynamic Naming and Configuration Service）是阿里巴巴开源的一款集服务发现、配置管理和服务管理于一体的平台。Nacos 的名字来源于Naming andConfigurationService 的缩写。

1.2 Nacos 的核心特性

1.2.1 服务发现与服务健康监测

服务注册：微服务启动时自动向 Nacos 注册自己的实例信息
服务发现：服务消费者可以从 Nacos 获取可用的服务实例列表
健康检查：支持 TCP/HTTP 健康检查，自动剔除不健康实例
负载均衡：内置权重管理和流量控制策略

1.2.2 动态配置管理

配置集中管理：所有环境配置集中存储在 Nacos 中
动态刷新：支持配置的动态刷新，无需重启应用
多环境支持：支持命名空间（Namespace）隔离不同环境
版本管理：配置的版本管理和一键回滚
监听查询：实时监听配置变化并通知客户端

1.2.3 动态 DNS 服务

支持权重路由
更易于实现自定义负载均衡策略
支持路由规则灵活调整

1.2.4 服务及其元数据管理

服务元数据管理
服务端点管理
服务生命周期管理

1.3 Nacos 的架构优势

易用性：提供简单的 UI 控制台，易于操作
高可用：支持集群部署，保证高可用性
可扩展：插件化设计，易于扩展功能
多语言支持：支持 Java、Go、Python 等多种语言
与 Spring Cloud 生态完美集成：无缝替代 Eureka、Config 等组件

二、Spring Cloud 集成 Nacos 详细步骤

2.1 环境准备

2.1.1 Nacos Server 安装

# 下载 Nacos Server（以 2.2.3 版本为例） wget https://github.com/alibaba/nacos/releases/download/2.2.3/nacos-server-2.2.3.tar.gz # 解压 tar -zxvf nacos-server-2.2.3.tar.gz # 启动（单机模式） cd nacos/bin sh startup.sh -m standalone # 访问控制台 # http://localhost:8848/nacos # 默认账号/密码：nacos/nacos

2.2 创建 Spring Boot 项目

2.2.1 Maven 父工程 pom.xml

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.example</groupId> <artifactId>spring-cloud-nacos-demo</artifactId> <version>1.0.0</version> <packaging>pom</packaging> <parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.14</version> <relativePath/> </parent> <properties> <java.version>1.8</java.version> <spring-cloud.version>2021.0.8</spring-cloud.version> <spring-cloud-alibaba.version>2021.0.5.0</spring-cloud-alibaba.version> </properties> <dependencyManagement> <dependencies> <!-- Spring Cloud 依赖管理 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-dependencies</artifactId> <version>${spring-cloud.version}</version> <type>pom</type> <scope>import</scope> </dependency> <!-- Spring Cloud Alibaba 依赖管理 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-alibaba-dependencies</artifactId> <version>${spring-cloud-alibaba.version}</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement> <modules> <module>nacos-provider</module> <module>nacos-consumer</module> <module>nacos-config</module> <module>nacos-gateway</module> </modules> </project>

2.3 服务注册与发现

2.3.1 服务提供者（Provider）

pom.xml

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>spring-cloud-nacos-demo</artifactId> <groupId>com.example</groupId> <version>1.0.0</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>nacos-provider</artifactId> <dependencies> <!-- Web 依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Nacos 服务发现 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> </dependency> <!-- 健康检查 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> </dependencies> </project>

application.yml

server: port: 8081 spring: application: name: nacos-provider-service cloud: nacos: discovery: # Nacos Server 地址 server-addr: localhost:8848 # 命名空间，用于环境隔离（默认public） namespace: public # 分组（默认DEFAULT_GROUP） group: DEFAULT_GROUP # 集群名称 cluster-name: BJ # 服务注册的IP ip: 127.0.0.1 # 服务注册的端口 port: 8081 # 元数据 metadata: version: 1.0 author: example # 是否启用Nacos enabled: true # 健康检查配置 management: endpoints: web: exposure: include: '*' endpoint: health: show-details: always

启动类 ProviderApplication.java

package com.example.provider; 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.PathVariable; import org.springframework.web.bind.annotation.RestController; @SpringBootApplication @EnableDiscoveryClient // 启用服务发现 public class ProviderApplication { public static void main(String[] args) { SpringApplication.run(ProviderApplication.class, args); } } @RestController class ProviderController { @GetMapping("/hello/{name}") public String hello(@PathVariable String name) { return String.format("Hello %s, this is nacos provider!", name); } @GetMapping("/health") public String health() { return "Provider service is healthy!"; } }

2.3.2 服务消费者（Consumer）

pom.xml

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>spring-cloud-nacos-demo</artifactId> <groupId>com.example</groupId> <version>1.0.0</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>nacos-consumer</artifactId> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Nacos 服务发现 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> </dependency> <!-- OpenFeign 服务调用 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-openfeign</artifactId> </dependency> <!-- LoadBalancer 负载均衡 --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-loadbalancer</artifactId> </dependency> </dependencies> </project>

application.yml

server: port: 8082 spring: application: name: nacos-consumer-service cloud: nacos: discovery: server-addr: localhost:8848 namespace: public group: DEFAULT_GROUP # 启用 LoadBalancer spring.cloud.loadbalancer.ribbon.enabled: false # Feign 配置 feign: client: config: default: connectTimeout: 5000 readTimeout: 5000 loggerLevel: basic

启动类 ConsumerApplication.java

package com.example.consumer; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.client.discovery.EnableDiscoveryClient; import org.springframework.cloud.client.loadbalancer.LoadBalanced; import org.springframework.cloud.openfeign.EnableFeignClients; import org.springframework.context.annotation.Bean; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RestController; import org.springframework.web.client.RestTemplate; @SpringBootApplication @EnableDiscoveryClient @EnableFeignClients public class ConsumerApplication { public static void main(String[] args) { SpringApplication.run(ConsumerApplication.class, args); } @Bean @LoadBalanced // 启用负载均衡 public RestTemplate restTemplate() { return new RestTemplate(); } } @RestController class ConsumerController { private final RestTemplate restTemplate; private final ProviderFeignClient providerFeignClient; public ConsumerController(RestTemplate restTemplate, ProviderFeignClient providerFeignClient) { this.restTemplate = restTemplate; this.providerFeignClient = providerFeignClient; } // 使用 RestTemplate 调用 @GetMapping("/call/rest/{name}") public String callByRestTemplate(@PathVariable String name) { String url = "http://nacos-provider-service/hello/" + name; return restTemplate.getForObject(url, String.class); } // 使用 Feign 调用 @GetMapping("/call/feign/{name}") public String callByFeign(@PathVariable String name) { return providerFeignClient.hello(name); } } // Feign 客户端接口 @org.springframework.cloud.openfeign.FeignClient( value = "nacos-provider-service", path = "/" ) interface ProviderFeignClient { @GetMapping("/hello/{name}") String hello(@PathVariable String name); @GetMapping("/health") String health(); }

2.4 配置中心集成

2.4.1 配置管理模块

pom.xml

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>spring-cloud-nacos-demo</artifactId> <groupId>com.example</groupId> <version>1.0.0</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>nacos-config</artifactId> <dependencies> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Nacos 配置管理 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId> </dependency> <!-- Nacos 服务发现 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> </dependency> <!-- 配置刷新 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-actuator</artifactId> </dependency> </dependencies> </project>

bootstrap.yml（配置文件优先级高于 application.yml）

# bootstrap.yml spring: application: name: nacos-config-service profiles: active: dev cloud: nacos: config: # Nacos Server 地址 server-addr: localhost:8848 # 配置文件后缀 file-extension: yaml # 命名空间（环境隔离） namespace: dev # 分组 group: DEFAULT_GROUP # 共享配置 shared-configs: ->2.5 使用 Spring Cloud Gateway 集成 Nacospom.xml
<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> <parent> <artifactId>spring-cloud-nacos-demo</artifactId> <groupId>com.example</groupId> <version>1.0.0</version> </parent> <modelVersion>4.0.0</modelVersion> <artifactId>nacos-gateway</artifactId> <dependencies> <!-- Spring Cloud Gateway --> <dependency> <groupId>org.springframework.cloud</groupId> <artifactId>spring-cloud-starter-gateway</artifactId> </dependency> <!-- Nacos 服务发现 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId> </dependency> <!-- Nacos 配置中心 --> <dependency> <groupId>com.alibaba.cloud</groupId> <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId> </dependency> </dependencies> </project>
application.yml
server: port: 8080 spring: application: name: nacos-gateway cloud: nacos: discovery: server-addr: localhost:8848 namespace: public group: DEFAULT_GROUP gateway: discovery: locator: enabled: true # 启用服务发现 lower-case-service-id: true routes: - id: provider-service uri: lb://nacos-provider-service predicates: - Path=/provider/** filters: - StripPrefix=1 - AddRequestHeader=X-Request-Foo, Bar - name: RequestRateLimiter args: redis-rate-limiter.replenishRate: 10 redis-rate-limiter.burstCapacity: 20 key-resolver: "#{@pathKeyResolver}" - id: consumer-service uri: lb://nacos-consumer-service predicates: - Path=/consumer/** filters: - StripPrefix=1 - id: config-service uri: lb://nacos-config-service predicates: - Path=/config/** filters: - StripPrefix=1
网关配置类 GatewayApplication.java
package com.example.gateway; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.cloud.client.discovery.EnableDiscoveryClient; import org.springframework.cloud.gateway.filter.ratelimit.KeyResolver; import org.springframework.context.annotation.Bean; import reactor.core.publisher.Mono; @SpringBootApplication @EnableDiscoveryClient public class GatewayApplication { public static void main(String[] args) { SpringApplication.run(GatewayApplication.class, args); } @Bean public KeyResolver pathKeyResolver() { return exchange -> Mono.just( exchange.getRequest().getPath().value() ); } }
2.6 Nacos 集群部署配置（可选）
cluster.conf 配置
properties
# Nacos 集群节点配置 192.168.1.101:8848 192.168.1.102:8848 192.168.1.103:8848
application.properties 配置
properties
# 集群模式 spring.datasource.platform=mysql db.num=1 db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC db.user=root db.password=123456
三、详细总结
3.1 集成优势
3.1.1 一站式解决方案
Nacos 提供了服务发现和配置管理的统一平台，避免了使用多个独立组件（如 Eureka + Config + Bus）带来的复杂性和维护成本。
3.1.2 高性能与高可用
服务发现：基于 Raft 协议，保证数据一致性
配置管理：基于 Derby/MySQL 存储，支持集群部署
健康检查：支持 TCP/HTTP/MYSQL 多种健康检查方式
3.1.3 易于使用和运维
提供友好的 Web 控制台
完整的 RESTful API
丰富的监控指标
3.2 最佳实践建议
3.2.1 命名空间规划
# 建议按环境划分命名空间 namespace: dev: 开发环境 test: 测试环境 pre: 预发环境 prod: 生产环境
3.2.2 配置管理策略
配置分类存储：公共配置：使用shared-configs
应用配置：按应用独立存储
环境配置：使用不同命名空间
配置版本控制：重要配置变更前进行备份
使用配置历史版本功能
建立配置变更审核机制
3.2.3 服务治理
权重管理：根据服务器性能设置不同权重
元数据管理：利用 metadata 存储版本、区域等信息
集群容灾：配置多个集群，实现容灾切换
3.3 注意事项
3.3.1 网络与安全
生产环境建议使用内网域名访问
启用 Nacos 的认证功能
配置合适的网络策略和防火墙规则
3.3.2 监控与告警
监控 Nacos Server 的 CPU、内存、磁盘使用率
设置服务实例数异常告警
监控配置变更频率
3.3.3 容量规划
根据服务实例数量规划 Nacos 集群规模
定期清理无效的服务实例
监控配置数量，避免配置过多影响性能
3.4 故障排查指南
3.4.1 常见问题
服务注册失败：检查网络连通性
验证 Nacos Server 状态
检查命名空间和分组配置
配置无法刷新：确认@RefreshScope注解已添加
检查配置 Data ID 和 Group 是否正确
验证应用是否有读取配置的权限
服务发现异常：检查健康检查配置
验证负载均衡策略
查看服务实例元数据
3.4.2 日志分析
Nacos Server 日志：logs/nacos.log
客户端日志：设置logging.level.com.alibaba.cloud.nacos=DEBUG
网关日志：启用 Gateway 的详细日志
3.5 性能优化建议
客户端配置优化：
spring: cloud: nacos: discovery: # 心跳间隔（默认5秒） heart-beat-interval: 5000 # 心跳超时（默认15秒） heart-beat-timeout: 15000 # 实例刷新间隔（默认30秒） instance-poll-interval: 30000
服务端优化：根据实例数量调整 JVM 参数
使用 MySQL 替代内嵌数据库
配置合适的集群节点数量
3.6 扩展功能
3.6.1 配置监听
@NacosConfigListener(dataId = "nacos-config-service-dev.yaml") public void onMessage(String config) { log.info("Config changed: {}", config); // 处理配置变更逻辑 }
3.6.2 服务事件监听
@Component public class ServiceChangeListener { @EventListener public void onInstanceChange(NamingEvent event) { log.info("Service {} instances changed: {}", event.getServiceName(), event.getInstances()); } }
3.7 迁移建议
从传统的 Spring Cloud Netflix 组件迁移到 Nacos：
Eureka → Nacos Discovery：无缝迁移，只需更改依赖和配置
Config + Bus → Nacos Config：简化架构，减少组件依赖
Ribbon → Nacos + LoadBalancer：更灵活的服务路由
3.8 最后
Nacos 作为云原生时代的服务基础设施，正在持续演进：
更好的 Kubernetes 集成
更强大的服务治理能力
更完善的可观测性支持
多语言 SDK 的持续丰富
通过 Spring Cloud Alibaba Nacos 的集成，可以获得一个功能完整、性能优异、易于运维的微服务基础设施平台，大大降低了微服务架构的复杂度和维护成本。
谢谢你看我的文章，既然看到这里了，如果觉得不错，随手点个赞、转发、在看三连吧，感谢感谢。那我们，下次再见。
您的一键三连，是我更新的最大动力，谢谢
山水有相逢，来日皆可期，谢谢阅读，我们再会
我手中的金箍棒，上能通天，下能探海