Spring Cloud 2021 版本配置 Nacos 命名空间隔离，需在 bootstrap.yml 中指定 spring.cloud.nacos.discovery.namespace-id 和 spring.cloud.nacos.config.namespace-id。该方案适用于多环境资源隔离场景，风险在于填写命名空间 ID 而非名称会导致注册失败。

命令速用版

配置核心在于 YAML 文件修改，无命令行操作，直接修改 bootstrap.yml 配置文件。

spring:
  cloud:
    nacos:
      discovery:
        namespace-id: 你的命名空间 ID
      config:
        namespace-id: 你的命名空间 ID

为什么会这样

Nacos 命名空间用于逻辑隔离配置和服务数据，不同命名空间下的数据互不可见。Spring Cloud Alibaba 2021 版本默认连接 public 命名空间，不配置则无法隔离环境。

分步处理

1. 获取 ID：登录 Nacos 控制台，点击命名空间列表，复制目标环境的命名空间 ID。

2. 修改配置：在项目的 bootstrap.yml 文件中添加 namespace-id 配置项。

3. 重启服务：重新启动 Spring Boot 应用，确保配置加载。

4. 检查日志：观察启动日志中 Nacos 连接信息，确认 namespace 参数已传递。

怎么验证是否生效

登录 Nacos 控制台服务列表，确认服务实例仅出现在目标命名空间下。查看应用日志，搜索 "namespace" 关键字确认配置值。

常见坑

1. 误填命名空间名称：配置项需要的是 ID（通常为 UUID 或自定义字符串），填名称会导致连接 default 公共空间。

2. 发现与配置不一致：discovery 和 config 的 namespace-id 建议保持一致，否则服务能注册但配置拉取失败。

3. 公共空间 ID 为空：public 命名空间的 ID 为空字符串，不配置默认即为公共空间。

常见问题

默认命名空间 ID 是什么？

public 命名空间的 ID 为空字符串，不配置 namespace-id 属性默认连接公共空间。

配置后服务找不到怎么办？

检查客户端配置的 namespace-id 是否与 Nacos 控制台显示的 ID 完全一致，包括大小写。

参考来源

• Spring Cloud Alibaba Wiki, Nacos Config 配置项说明，https://github.com/alibaba/spring-cloud-alibaba/wiki
• Nacos 官方文档，命名空间概念介绍，https://nacos.io/zh-cn/docs/concept.html