Nacos 迁移方案

更新时间：2025-03-31

概述

如果您计划使用微服务引擎 MSE 替代 Nacos 作为新的注册配置中心，MSE 提供了协议兼容方案，您只需更改应用中 nacos-client 的服务端接入地址，无需修改代码或调整 pom 依赖。本文将围绕服务注册与配置管理两大核心场景，详细阐述 MSE 接入的使用方法。

前提条件

已创建注册配置中心实例，详情参见创建注册配置中心实例。

场景一：服务注册

1. Nacos 服务名和 MSE 注册中心服务名映射关系

Nacos 字段	Nacos 字段值	MSE 字段	MSE 字段值描述
namespace	默认命名空间/非默认命名空间 ID	namespace	""/命名空间名称
group	DEFAULT_GROUP	service	MSE 服务名称由 nacos group 字段值和 nacos service 字段值拼接而成。${group}__${service} 为最终的 MSE 服务名，如果 group == DEFAULT_GROUP，则服务名为 ${service}。
service	DEFAULT_GROUP	service

2. 修改服务端接入地址

若为 Spring Cloud Alibaba，修改应用配置文件：

Properties

1spring.cloud.nacos.username="留空即可"
2spring.cloud.nacos.password="留空即可"
3spring.cloud.nacos.discovery.server-addr="MSE 服务端 IP:8848/9848"
4spring.cloud.nacos.discovery.namespace="MSE 命名空间名称"

服务端 IP 地址查看方式：
1. 登录 MSE 控制台。
2. 在 MSE 实例列表中，点击目标实例名称/ID，进入基本信息页面。
3. 在实例的 基本信息 - Server 访问地址，可以看到实例的内网地址。

场景二：配置管理

1. Nacos 配置信息和 MSE 配置信息映射关系

Nacos 字段	Nacos 字段值	MSE 字段	MSE 字段值描述
namespace	默认命名空间/非默认命名空间 ID	namespace	""/命名空间名称
group	DEFAULT_GROUP	group	MSE 配置分组名称
dataId	application.yaml	file_name	MSE 配置文件名称

2. 修改服务端接入地址

若为 Spring Cloud Alibaba，修改应用配置文件：

Properties

1spring.cloud.nacos.username="留空即可"
2spring.cloud.nacos.password="留空即可"
3spring.cloud.nacos.config.namespace="MSE 命名空间名称"
4spring.cloud.nacos.config.server-addr="MSE 服务端 IP:8848/9848"
5spring.cloud.nacos.config.group="MSE 配置分组名称"

3. 配置文件的导入可参考：导入配置

配置管理