今天来到了实战篇，大家一定要熟悉最基本的使用方法，以后在微服务开发中离不了nacos的使用。

如何在Spring Cloud项目中集成Nacos？

在 Spring Cloud 项目中集成 Nacos（作为服务注册中心和配置中心）的步骤清晰且可复用，以下是详细的集成流程、配置示例及核心代码说明。

一、环境准备

1. 安装 Nacos 服务器

• 从Nacos 官网下载最新版本（推荐 2.x），解压后启动：
• 单机模式启动（Windows）：bin/startup.cmd -m standalone
• 单机模式启动（Linux/Mac）：bin/startup.sh -m standalone
• 启动成功后，访问控制台：http://localhost:8848/nacos，默认账号密码为nacos/nacos。

二、项目依赖配置

Nacos 是 Spring Cloud Alibaba 生态组件，需先确定版本兼容性（关键！）。

推荐组合：

• Spring Boot：2.7.x
• Spring Cloud：2021.0.5
• Spring Cloud Alibaba：2021.0.5.0

1. 父工程依赖（统一版本管理）

在pom.xml中添加版本锁定：

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

<properties>
    <spring-cloud.version>2021.0.5</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>

2. 子模块依赖（核心功能）

在业务模块的pom.xml中添加 Nacos 服务发现和配置中心依赖：

<dependencies>
    <!-- Spring 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>

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

三、配置文件（核心）

Nacos 配置中心的配置需放在bootstrap.yml（或bootstrap.properties）中（优先级高于application.yml，确保启动时优先加载 Nacos 配置）。

1. bootstrap.yml（配置中心连接信息）

# 应用名称（Nacos配置中心的Data ID默认以此为前缀）
spring:
  application:
    name: nacos-demo-service  # 必须配置，用于服务注册和配置中心定位

  # Nacos 配置中心配置
  cloud:
    nacos:
      config:
        server-addr: localhost:8848  # Nacos服务器地址
        file-extension: yml  # 配置文件格式（支持properties/yml，默认properties）
        group: DEFAULT_GROUP  # 配置分组（默认DEFAULT_GROUP，可自定义，如DEV_GROUP）
        # namespace: 8f8a8c80-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # 命名空间ID（默认public，用于环境隔离）

2. application.yml（服务发现及本地补充配置）

spring:
  cloud:
    nacos:
      # Nacos 服务注册与发现配置
      discovery:
        server-addr: localhost:8848  # 与配置中心地址一致（可分开配置）
        # namespace: 8f8a8c80-xxxx-xxxx-xxxx-xxxxxxxxxxxx  # 需与配置中心命名空间一致

# 应用端口（避免冲突，如8081）
server:
  port: 8081

四、代码开发（启用功能并测试）

1. 主启动类（开启服务发现）

添加@EnableDiscoveryClient注解开启服务注册与发现功能：

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.discovery.EnableDiscoveryClient;

@SpringBootApplication
@EnableDiscoveryClient  // 开启Nacos服务注册与发现
public class NacosDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(NacosDemoApplication.class, args);
    }
}

2. 配置中心测试（动态获取配置）

创建 Controller，通过@Value获取 Nacos 配置中心的配置，并支持动态刷新：

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;

@RestController
@RefreshScope  // 关键：开启配置动态刷新（修改Nacos配置后无需重启服务）
public class ConfigController {

    // 从Nacos配置中心获取key为"user.name"的配置
    @Value("${user.name:defaultName}")
    private String userName;

    // 测试接口：返回配置值
    @GetMapping("/config/name")
    public String getConfigName() {
        return "当前配置的user.name：" + userName;
    }
}

五、Nacos 控制台配置（关键步骤）

1. 添加配置

登录 Nacos 控制台（
http://localhost:8848/nacos），进入「配置管理」→「配置列表」，点击「+」新增配置：

• Data ID：nacos-demo-service.yml（格式：{file-extension}，与 bootstrap.yml 对应）
• Group：DEFAULT_GROUP（与 bootstrap.yml 的 group 一致）
• 配置内容：

user:
  name: 张三  # 与Controller中@Value的key对应

• 点击「发布」。

1. 验证服务注册

启动应用后，进入 Nacos 控制台「服务管理」→「服务列表」，可看到服务nacos-demo-service已注册（IP 为应用所在机器 IP，端口 8081）。

1. 测试动态配置

• 访问接口：http://localhost:8081/config/name，返回当前配置的user.name：张三。
• 在 Nacos 控制台修改配置内容为user.name: 李四，点击「发布」。
• 再次访问接口，无需重启服务，返回当前配置的user.name：李四（动态刷新生效）。

六、关键配置说明

七、常见问题

1. 配置不生效：检查 Data ID、Group、Namespace 是否与 bootstrap.yml 一致；确保配置文件类型（yml/properties）正确。
2. 服务注册失败：检查 Nacos 服务器是否启动；server-addr是否正确；防火墙是否开放 8848 端口。
3. 动态刷新失败：忘记添加@RefreshScope注解；配置修改后未点击 Nacos 控制台的「发布」。

通过以上步骤，即可在 Spring Cloud 项目中完整集成 Nacos 的服务注册发现和配置中心功能，实现服务治理与动态配置管理。