MSE Nacos SDK的应用和Nacos SDK限制使用版本

技术栈

框架

原生SDK

Spring Boot

Spring Cloud

Dubbo（Dubbo-Go）

Kitex

Java

Nacos提供了Java SDK连接引擎的方式，详情请参见Java SDK。

Nacos为Spring Boot架构的用户提供了完善的接入方案，详情请参见Nacos Spring Boot快速开始。

Nacos提供了Spring Cloud的接入方式，详情请参见Nacos Spring Cloud快速开始。

Dubbo是一个高性能优秀的服务框架，使得应用可通过高性能的RPC实现服务注册到Nacos并相互调用，详情请参见如何在MSE上为Dubbo应用构建服务注册中心。

-

Golang

Go用户可以使用示例工程，快速搭建基于Go的框架。

-

-

Apache Dubbo-Go支持Go用户基于Nacos搭建RPC服务，详情请参见Apache Dubbo-Go。

Kitex是一款基于Golang微服务RPC框架，默认集成了Nacos注册中心，详情请参见如何在MSE上为Kitex应用构建服务注册中心。

Node.js

Nacos提供Node.js的连接方式，详情请参见基于Node.js的微服务系统。

-

-

-

-

Python

Python用户可以使用Nacos-SDK-Python，集成Nacos搭建微服务系统。

-

-

-

-

服务网格

Nacos支持以MCP标准接入，详情请参见新建服务来源。

-

-

-

-

不推荐版本

不推荐原因

解决方案

0.X～1.1.X

不支持轻量级服务心跳，导致心跳包过大，影响性能。更多信息，请参见详情。

升级至1.2.0及以上版本。

1.4.1 ~ 1.4.2

• 1.4.1版本当DNS不可用，域名解析失败时，导致心跳线程意外退出，服务掉线且无法自愈。更多信息，请参见详情。

• 1.4.2版本使用配置加解密功能时，getConfigAndSignListener接口查询加密配置时返回内容为明文。

升级至1.4.3及以上版本。

不推荐版本

不推荐原因

解决方案

1.0.1～1.1.3

客户端版本显示均为1.0.1，无法准确识别客户端版本，且同时存在两个较严重Bug，可能导致频繁通知变更或出现心跳中断等问题。

• 如果使用MSE基础版引擎，请将客户端升级至1.1.4及以上版本。

• 如果使用MSE专业版引擎，请将客户端升级至2.1.1及以上版本。

2.0.0～2.1.0

客户端版本均显示为2.0.0，无法准确识别客户端版本，且当出现连接重连后，该版本的实例不会自动重新注册和订阅服务，导致服务掉线且无法自愈。更多信息，请参见详情。

升级至2.1.1及以上版本。

不推荐版本

不推荐原因

解决方案

2.7.5及以下版本

订阅多个服务时，无法获取到Provider的地址列表变化，导致流量路由到下线或不存在的Provider上。更多信息，请参见详情。

升级至2.7.5及以上版本。

2.7.8

Dubbo会创建非常多Nacos Client实例，从而导致连接数，线程数暴涨，极大影响客户端和服务端稳定性。更多信息，请参见详情。

升级至2.7.9及以上版本。

2.7.11

默认依赖了Nacos-Java-Client 1.4.1版本。

• 升级至2.7.12及以上版本。

• 修改Nacos Client版本为1.4.2及以上版本。

2.7.19及以下版本

Dubbo在订阅服务时，会同时订阅一个服务的多个服务名，但在聚合地址列表时会导致Consumer概率性找不到Provider。更多信息，请参见详情。

升级至2.7.20以上版本。

3.0.0～3.1.5

升级至3.1.6以上版本。

不推荐版本

不推荐原因

解决方案

2.2.4以下版本

会覆盖Nacos Client的日志配置，导致大量Nacos的日志输出到应用的业务日志中，对应用的问题排查造成影响。更多信息，请参见详情。

升级至2.2.6.RELEASE以上版本。

2.2.4.RELEASE & 2.2.5.RELEASE

默认依赖Nacos-Java-Client 1.4.1版本。

• 升级至2.2.6.RELEASE以上版本。

• 修改Nacos Client版本为1.4.2及以上版本。