在 Spring Boot 项目中配置 Nacos 实现多环境隔离，最稳妥的方式是通过 Nacos 控制台创建独立的命名空间 ID，并在 bootstrap 配置中指定该 ID 配合 Spring Profile 激活。

前置准备：依赖与版本兼容性

在开始配置前，需确保项目引入了正确的依赖。特别是 Spring Cloud 2020.0.0 及以上版本，默认不再支持 bootstrap 配置文件，需额外引入适配依赖。

Maven 依赖示例：

<dependencies>    <!-- Nacos 配置管理依赖 -->    <dependency>        <groupId>com.alibaba.cloud</groupId>        <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>    </dependency>    <!-- Spring Cloud 2020.0.0+ 必须引入，否则 bootstrap.yml 不生效 -->    <dependency>        <groupId>org.springframework.cloud</groupId>        <artifactId>spring-cloud-starter-bootstrap</artifactId>    </dependency></dependencies>

版本注意：若使用 Spring Cloud 2020.0.0 (Ilford) 或更高版本，务必引入 spring-cloud-starter-bootstrap。否则 bootstrap.yml 将被忽略，导致命名空间配置无法在启动初期加载。

核心配置步骤

第一步：在 Nacos 控制台创建命名空间

登录 Nacos 控制台，进入“命名空间”菜单，点击“新建命名空间”。分别创建 dev、test、prod 等环境。创建完成后，务必复制每个命名空间对应的“命名空间 ID”（通常是一串 UUID 或自定义字符），不要使用命名空间名称。

第二步：配置 bootstrap.yml

在项目的 src/main/resources 目录下创建 bootstrap.yml。配置 Nacos 地址、命名空间 ID 及文件扩展名。建议将 namespace 配置通过环境变量动态传入，便于 CI/CD 管理。

spring:  application:    name: app-service  cloud:    nacos:      config:        server-addr: 127.0.0.1:8848        # 填写控制台复制的命名空间 ID，而非名称        namespace: ${NACOS_NAMESPACE:public}        file-extension: yaml        # 默认规则：${spring.application.name}-${spring.profile.active}.${file-extension}        prefix: ${spring.application.name}  profiles:    active: dev

第三步：配置 Data ID 规则

确保 Nacos 控制台中的配置列表 Data ID 与项目配置匹配。默认加载规则为 ${prefix}-${spring.profile.active}.${file-extension}。例如应用名为 app-service，环境为 dev，则需在对应命名空间下创建 Data ID 为 app-service-dev.yaml 的配置。

验证配置生效

1. 查看启动日志

启动 Spring Boot 应用，观察控制台日志。搜索关键字 Located config file 或 Load config from Nacos。确认日志中打印的 namespace 与你配置的 ID 一致，且没有报错。

2. 检查 Nacos 控制台监听

在 Nacos 控制台的“配置管理”列表页，选择对应的命名空间，查看配置详情。部分版本支持查看“监听器列表”，确认当前应用 IP 已订阅该配置。

3. 使用 Actuator 端点

如果项目引入了 spring-boot-starter-actuator，可以访问 /actuator/configprops 或 /actuator/env 端点，查看实际加载的配置值是否符合当前环境预期。

常见故障排查

1. bootstrap.yml 不生效

现象：配置未加载，应用使用本地默认值。
原因：Spring Cloud 2020.0.0+ 版本未引入 spring-cloud-starter-bootstrap 依赖。
解决：检查 pom.xml 是否包含该依赖，并重新构建项目。

2. 命名空间 ID 与名称混淆

现象：启动报错或加载了 public 空间配置。
原因：配置文件中填写的是“命名空间名称”（如 dev），而非“命名空间 ID”（如 56c55...）。
解决：回到 Nacos 控制台，复制准确的 namespace ID 填入配置。

3. 配置优先级问题

现象：Nacos 配置修改后未生效。
原因：本地 application.yml 中硬编码了配置值，优先级高于 Nacos 远程配置。
解决：本地配置文件只保留基础结构，具体业务值交给 Nacos 管理，或检查配置加载顺序。

4. Profile 不匹配

现象：加载了错误的 Data ID。
原因：启动时激活的 Profile 与 Nacos 中配置的 Data ID 后缀不一致。
解决：确认启动参数 `--spring`.profiles.active=dev 与 Nacos 中配置文件的后缀（如 -dev.yaml）一致。