Nacos 配置中心如何监听多个 dataId 实现动态刷新配置？

在 Spring Cloud Alibaba 微服务架构中，实现 Nacos 配置中心监听多个 dataId 并动态刷新，核心在于正确配置 extension-configs 并结合 @RefreshScope 注解。以下是经过生产验证的实施步骤。

先说结论：原生 Nacos SDK 需手动编写监听逻辑，而 Spring Cloud Alibaba 封装了多 dataId 加载与刷新机制，更适合大多数业务场景。

适合：基于 Spring Cloud 构建的微服务应用
先准备：确认 Nacos 服务端版本与客户端 SDK 兼容，注意 Spring Cloud 2020+ 版本需额外引入 bootstrap 依赖
验收：修改配置后观察日志及接口返回变量值是否变化

1. 依赖与版本兼容性

确保项目中包含 Nacos Config 依赖。特别注意，Spring Cloud 2020.0.0 及以上版本默认移除了 bootstrap 上下文，需额外引入 spring-cloud-starter-bootstrap 否则配置无法加载。

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

<!-- Spring Cloud 2020+ 必须引入 -->
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

2. 配置文件设置

在 bootstrap.yml 或 application.yml 中声明多个 dataId。建议将共享配置放在 extension-configs 中，并开启 refresh 属性。

spring:
  cloud:
    nacos:
      config:
        server-addr: 127.0.0.1:8848
        file-extension: yaml
        extension-configs:
          - data-id: common-config.yaml
            group: DEFAULT_GROUP
            refresh: true
          - data-id: db-config.yaml
            group: DEFAULT_GROUP
            refresh: true

3. 代码实现与刷新作用域

使用 @RefreshScope 注解标记需要动态刷新的 Bean。以下示例展示了一个配置类和一个用于验证的 Controller。

@RestController
@RefreshScope
public class ConfigController {

    @Value("${custom.setting:default}")
    private String customSetting;

    @GetMapping("/config/get")
    public String getConfig() {
        return "Current Setting: " + customSetting;
    }
}

4. 验证步骤

1. 启动应用，检查日志确认多个 dataId 加载成功（搜索 Loaded config）。

2. 访问 http://localhost:8080/config/get 记录当前返回值。

3. 登录 Nacos 控制台，修改 common-config.yaml 中 custom.setting 的值并发布。

4. 再次访问接口，确认返回值已更新，且控制台打印 Refreshing bean 相关日志。

5. 常见坑与排查

Bootstrap 依赖缺失：Spring Cloud 2020+ 未引入 spring-cloud-starter-bootstrap 会导致 bootstrap.yml 不生效。
命名空间不一致：客户端配置的 namespace ID 必须与控制台创建配置时的 namespace ID 完全一致。
文件扩展名：dataId 后缀需与 file-extension 或配置内容格式匹配，否则解析失败。
@RefreshScope 位置：注解需加在类级别，加在方法上通常无效。
循环依赖：刷新作用域可能导致 Bean 重新创建，复杂依赖结构可能引发启动报错。

参考来源

1. Nacos 官方文档 - 快速开始，https://nacos.io/zh-cn/docs/quick-start.html

2. Spring Cloud Alibaba Wiki - Nacos Config，https://github.com/alibaba/spring-cloud-alibaba/wiki/Nacos-config