Spring Boot 3.x 集成 Nacos 实战：多环境配置最佳实践

一、背景与整体思路

• Nacos 作用：服务发现 + 配置中心
• 多环境需求：开发（dev）、测试（test）、生产（prod）环境分离
• 实现方式：
• spring.profiles.active 决定当前环境
• Nacos Data ID 遵循规则：{appname}-{profile}.{ext}
• Namespace 实现环境隔离
• @RefreshScope 实现配置热更新

二、安装 Nacos Server

• 下载并启动（单机模式 -m standalone）
• 控制台地址：http://localhost:8848/nacos
• 默认账号：nacos / nacos

三、Spring Boot 3.x 项目配置

1. 使用 Spring Initializr 创建项目（选择 Boot 3.x）
2. 添加依赖：

<spring-cloud.version>2022.0.4</spring-cloud.version>
<spring-cloud-alibaba.version>2022.0.0.0</spring-cloud-alibaba.version>

并引入：

spring-cloud-starter-alibaba-nacos-discovery
spring-cloud-starter-alibaba-nacos-config

四、bootstrap.yml 配置（核心）

spring:
  application:
    name: demo-app
  profiles:
    active: dev
  cloud:
    nacos:
      config:
        server-addr: localhost:8848
        file-extension: yaml
        namespace: <dev命名空间ID>
        group: DEFAULT_GROUP
      discovery:
        server-addr: localhost:8848
        namespace: <dev命名空间ID>
        group: DEFAULT_GROUP

五、Nacos 多环境配置

• 创建命名空间（dev/test/prod）
• 配置 Data ID 规则：
• demo-app-dev.yaml
• demo-app-test.yaml
• demo-app-prod.yaml
• 示例配置：
• server: port: 8081 custom: config: Hello from Nacos Dev!

六、代码测试

1. 启动类：

@SpringBootApplication
@EnableDiscoveryClient
public class YourApplication { ... }

2. 配置读取：

@RestController
@RefreshScope
public class TestController {
    @Value("${custom.config:Local default}")
    private String customConfig;

    @GetMapping("/config")
    public String getConfig() {
        return customConfig;
    }
}

七、运行与验证

• 启动应用 → 日志显示已加载 Nacos 配置
• 访问 /config → 返回环境配置值
• 切换 -Dspring.profiles.active=test → 自动加载 demo-app-test.yaml
• 在 Nacos 修改配置 → /config 接口热更新

八、最佳实践总结

这样，你的项目就能在 Spring Boot 3.x 中无缝集成 Nacos，并优雅地支持 多环境配置和动态刷新。