分布式微服务--Nacos作为配置中心(二)

发布于：2025-08-03 ⋅ 阅读:(8) ⋅ 点赞:(0)

前言：Nacos 是什么？

Nacos（Naming and Configuration Service）是阿里巴巴开源的一个更易于构建云原生应用的动态服务发现、配置管理和服务管理平台。我们可以使用它：

✅作为注册中心（服务发现）

✅作为配置中心（集中化配置管理）

本篇重点讲 Nacos 作为配置中心 的使用。

一、什么是 Nacos 配置中心？🧠

Nacos（Dynamic Naming and Configuration Service） 是阿里开源的服务注册与配置管理中心。
作为配置中心，Nacos 提供了：

✅ 配置中心的核心作用：

传统配置文件（本地） Nacos（集中式配置）

配置分散、手动部署配置集中、统一管理

修改后需重启服务支持热更新

无法区分环境/服务支持命名空间、分组

不利于运维、灰度更适合动态配置、灰度发布

✅ 使用 Nacos 的优势：

📦 集中管理：所有微服务的配置集中托管在 Nacos 中。

🔄 动态刷新：配置修改后可动态生效，无需重启服务。

🌍 环境隔离：通过命名空间划分 dev/test/prod 等环境。

🧩 扩展灵活：支持配置共享、多文件加载、灰度发布等。

二、Nacos 配置中心使用流程 🚀

以下以 Spring Boot + Spring Cloud Alibaba 项目为例，详细介绍从依赖引入到动态刷新配置。

三、Nacos 配置使用详解 🛠️

1️⃣ 引入依赖（Maven）
<dependency>
    <groupId>com.alibaba.cloud</groupId>
    <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
    <version>0.2.2.RELEASE</version> 
</dependency>
若你同时使用注册中心：
<dependency>
   <groupId>com.alibaba.cloud</groupId>
   <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
   <version>0.2.2.RELEASE</version> 
</dependency>
2️⃣ 编写 bootstrap.yml（必须）

🚨 必须用 bootstrap.yml，因为 Spring 会在加载 application.yml 之前读取它，才能初始化 Nacos 配置。
spring:
  application:
    name: nacos-config-demo  # 会作为 dataId 的前缀

  profiles:
    active: dev  # 表示读取 nacos-config-demo-dev.yaml

  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yaml  # 支持 yaml/properties
        namespace: public  # 或使用 UUID（非默认空间）
        group: DEFAULT_GROUP
        refresh-enabled: true
✅ 最终读取的配置文件 dataId 是：
nacos-config-demo-dev.yaml

3️⃣ Nacos 控制台添加配置 ✍️

进入 http://localhost:8848：

Data ID: nacos-config-demo-dev.yaml

Group: DEFAULT_GROUP

配置格式: YAML

配置内容示例：
user:
  name: Alice
  age: 30
4️⃣ 编写配置绑定类（推荐方式）
@Configuration
@ConfigurationProperties(prefix = "user") // 自动绑定配置
public class UserConfig {
    private String name;
    private Integer age;

    // Getter & Setter
}
⚙️ 开启配置绑定支持（可省略）
@SpringBootApplication
@EnableConfigurationProperties
public class MyApp {
    public static void main(String[] args) {
        SpringApplication.run(MyApp.class, args);
    }
}
5️⃣ 控制器中使用配置 + 动态刷新

若希望修改配置后立即生效，需添加 @RefreshScope 注解。

@RefreshScope 背后做了啥
@RestController
@RefreshScope
public class UserController {

    @Autowired
    private UserConfig userConfig;

    @GetMapping("/user")
    public String getUser() {
        return userConfig.getName() + " - " + userConfig.getAge();
    }
}
四、拓展配置项（多个配置文件）
spring:
  cloud:
    nacos:
      config:
        extension-configs:
          - data-id: db-config.yaml
            group: DEFAULT_GROUP
            refresh: true
          - data-id: common.yaml
            group: DEFAULT_GROUP
            refresh: true
默认主配置是：nacos-config-demo-dev.yaml

可以引入多个扩展配置

支持刷新（refresh: true）

五、命名空间的使用（多环境隔离）

可在 Nacos 控制台创建多个 namespace 来区分环境：

环境 Namespace ID 说明

开发环境 dev-id 开发使用

测试环境 test-id 测试使用

生产环境 prod-id 正式使用

配置方式：
spring:
  cloud:
    nacos:
      config:
        namespace: dev-id
六、配置优先级（从高到低）

nacos-config-demo-dev.yaml（主配置）

extension-configs 中的多个配置

shared-configs（共享配置，可用于多个服务通用）

七、常见问题与排查 🔍

问题可能原因解决方式

配置读不到文件名或 profile 错确认 dataId 命名是否正确

无法动态刷新缺少 @RefreshScope 加在 Controller 或 Config 类上

只使用 @Value 失败 @Value 不支持批量刷新用 @ConfigurationProperties

不生效写在 application.yml 中了必须写在 bootstrap.yml

八、项目结构示例 🧱
src
├── main
│   ├── java
│   │   └── com.example.demo
│   │       ├── config/UserConfig.java
│   │       └── controller/UserController.java
│   └── resources
│       ├── bootstrap.yml  ✅ 必须
│       └── application.yml
九、结语 🧩

Nacos 配置中心是微服务配置管理的利器：

初学阶段建议：单环境单配置文件 先跑通再拓展

熟悉后可用：多命名空间 + 多配置文件 + 动态刷新 + 加密配置