Spring Cloud 多环境配置 Nacos 不同集群地址怎么实现

先说结论：通过 Spring Profile 配合启动参数切换 Nacos server-addr 是最标准做法，物理隔离建议直接改地址，逻辑隔离优先用 Namespace。

适合：多环境（dev/test/prod）对应不同 Nacos 集群场景
先准备：确认引入 spring-cloud-starter-bootstrap 依赖（Spring Cloud 2020.0.0+）
验收：查看启动日志确认连接到的 Nacos 地址是否符合预期

核心依赖配置

Spring Cloud 2020.0.0 版本后移除了 bootstrap 上下文，如需使用 bootstrap.yml 需额外引入依赖。

Maven 配置：

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-bootstrap</artifactId>
</dependency>

Gradle 配置：

implementation 'org.springframework.cloud:spring-cloud-starter-bootstrap'

配置文件示例

在 resources 目录下创建不同环境的配置文件，明确指定 Nacos 地址。

bootstrap.yml (公共引导配置)：

spring:
  application:
    name: your-service-name
  cloud:
    nacos:
      config:
        # 默认地址，可被 profile 覆盖
        server-addr: 127.0.0.1:8848
        file-extension: yaml

application-dev.yml (开发环境)：

spring:
  cloud:
    nacos:
      config:
        server-addr: 192.168.1.100:8848
        namespace: dev-namespace-id

application-prod.yml (生产环境)：

spring:
  cloud:
    nacos:
      config:
        server-addr: 10.0.0.100:8848
        namespace: prod-namespace-id

启动与部署

如果已经配置好 Profile 文件，启动时通过参数指定环境即可：

java -jar your-app.jar `--spring`.profiles.active=prod

或者通过环境变量传入地址（优先级高于配置文件）：

export SPRING_CLOUD_NACOS_CONFIG_SERVER_ADDR=192.168.1.100:8848

原理简述

Spring Cloud 配置加载有优先级顺序，命令行参数高于配置文件。Nacos 配置需要在应用启动早期加载，因此通常放在 bootstrap 上下文中。不同环境对应不同 Nacos 集群时，核心是确保在连接 Nacos 之前，地址参数已经被正确解析。

验证方法

查看启动日志：搜索 "Nacos" 关键字，确认日志中打印的连接地址（ServerAddr）是否与当前环境一致。
检查 Nacos 控制台：登录对应的 Nacos 控制台，查看配置列表是否有该服务的配置记录，确认 Data ID 和 Group 是否正确。
接口测试：调用获取配置接口，确认返回的是对应环境的配置值。

常见坑与排查

缺少 bootstrap 依赖：新版本 Spring Cloud 默认不启用 bootstrap，需手动添加 spring-cloud-starter-bootstrap，否则 profile 配置可能不生效。
Namespace 与集群地址混淆：Namespace 是同一集群内的逻辑隔离，不同集群必须改 server-addr，仅改 namespace 无法连接不同物理集群。
配置优先级被覆盖：确保没有在其他公共配置文件中写死地址，导致 Profile 配置失效。命令行参数优先级最高。
地址格式错误：server-addr 必须包含端口，例如 127.0.0.1:8848，多个地址用逗号分隔。

参考来源

1. Spring Cloud Alibaba 官方文档 - 配置管理 https://spring-cloud-alibaba-group.github.io/

2. Nacos 官方文档 - Spring Cloud 快速开始 https://nacos.io/zh-cn/docs/quick-start-spring-cloud.html