实战三：Nacos 配置中心多环境管理

本章用一个订单服务示例，把 Nacos 配置中心的多环境管理完整跑一遍：dev/test/prod 用命名空间隔离，profile 切换环境，共享配置下沉，最后验证动态刷新与回滚。接入方式以本教程版本锚点（spring-cloud-alibaba 2025.0.0.x）与官方文档为准。

环境规划

环境	namespace	说明
dev	dev-namespace-id	本地/开发，可随意改
test	test-namespace-id	测试联调，接近生产
prod	prod-namespace-id	生产，仅发布流程可改

一个 namespace 一套配置；dataId 统一命名 ${spring.application.name}-${spring.profiles.active}.${file-extension}：

order-service-dev.yaml      （dev 命名空间内）
order-service-test.yaml     （test 命名空间内）
order-service-prod.yaml     （prod 命名空间内）
common-datasource.yaml      （各命名空间内的共享配置）

客户端配置

# order-service application.yml
spring:
  application:
    name: order-service
  profiles:
    active: dev              # 启动参数可覆盖：--spring.profiles.active=prod
  cloud:
    nacos:
      config:
        server-addr: nacos.example.com:8848
        namespace: dev-namespace-id       # 指向 dev 命名空间
        file-extension: yaml
        shared-configs:                   # 共享配置：数据源等通用项
          - data-id: common-datasource.yaml
            refresh: true

新版接入推荐用 spring.config.import 加载远程配置（旧 bootstrap 方案已不建议，写法差异以官方文档为准），典型写法：

spring:
  config:
    import: nacos:order-service-dev.yaml?group=DEFAULT_GROUP&refreshEnabled=true

核心不变量：环境由 namespace + profile 共同定位，dataId 命名规范全团队统一。

配置动态刷新

远程配置放一个开关，验证“改配置不重启”：

# Nacos 中 order-service-dev.yaml
order:
  timeout-ms: 3000
  auto-approve: true

@RestController
@RefreshScope                // 配置变化后重建 Bean，@Value 重新注入
public class OrderConfigController {
    @Value("${order.timeout-ms:3000}")
    private int timeoutMs;

    @Value("${order.auto-approve:false}")
    private boolean autoApprove;

    @GetMapping("/order/config")
    public Map<String, Object> config() {
        return Map.of("timeoutMs", timeoutMs, "autoApprove", autoApprove);
    }
}

验证步骤：启动后访问 /order/config 记初值 → 控制台把 auto-approve 改为 false 并发布 → 日志出现变更回调 → 再访问接口看到新值，全程不重启进程。

多环境切换与隔离验证

1. 同一套代码，启动参数换 namespace 与 profile：dev 读 dev 配置、prod 读 prod 配置，互不可见。
2. 故意在 dev 共享配置写错数据源，确认 prod 不受影响（隔离生效）。
3. 在 prod 命名空间误改配置，用“历史版本”一键回滚，观察客户端自动刷新回旧值。

# 启动示例：切到 prod 环境（namespace ID 按实际填写）
java -jar order-service.jar \
  --spring.profiles.active=prod \
  --spring.cloud.nacos.config.namespace=prod-namespace-id

防呆与安全建议

• 覆盖关系写进规范：环境变量 > 启动参数 > 本地配置 > 远程配置，防止本地悄悄盖掉远程值。
• 敏感项按加密章节处理：密文进 Nacos，密钥走环境变量/KMS。
• prod 命名空间权限收敛：仅发布账号可写，普通开发只读。
• 配置变更纳入发布记录，能回答“这行配置谁在什么时候改的”。

小结

多环境配置骨架 = namespace 分环境 + profile 激活 + dataId 命名规范 + shared-configs 抽公共 + @RefreshScope 动态生效。跑通“改配置—自动刷新—回滚”闭环后，发布不再逐个实例改配置，环境差异彻底收敛到配置中心。