记一次使用nacos2踩到的坑

前言

本文素材来源朋友学习nacos2.1.1踩到的坑。直接上正菜

坑点一：出现端口被占用

因为是学习使用，朋友就在物理机搭建了搭建了nacos伪集群，即ip都一样，端口分别为8848,8847,8849。然而启动nacos服务器后，一台正常启动，其他两台都报了端口被占用

出现这种情况的原因，官网有做了解释

通过官网我们可以很容易得知，这个端口被占用主要是因为grpc引起的，因为他端口的生成方式，是由主端口+1000、主端口+1001生成。

解决方法

集群的端口不要采用相邻数字，步长尽量搞大点。比如设置为7777、8888、9999之类的

坑二：微服务项目启动出现com.alibaba.nacos.api.exception.NacosException: Client not connected, current status:STARTING异常

这个问题出现在朋友在项目中配置的nacos地址为nginx地址，配置示例如下

spring.cloud.nacos.discovery.server-addr=nginx ip

一开始朋友nginx的配置示例如下

upstream nacos-cluster { server 127.0.0.1:7777;server 127.0.0.1:8888;server 127.0.0.1:9999;   }    server {        listen       80;        server_name  localhost;        location / {            proxy_pass http://nacos-cluster;        }        }

浏览器通过nginx访问没问题，但是项目中把nacos服务地址配置为nginx ip就报了

com.alibaba.nacos.api.exception.NacosException: Client not connected, current status:STARTING

这个异常信息，后面朋友查资料，官网上有写

于是他就将转发方式改为TCP，他的nginx版本是1.9+以上版本，默认就支持TCP代理了，不用额外安装stream模块。nginx配置TCP的示例形如下

stream {upstream nacos-cluster-grpc{    # nacos2版本，grpc端口与要比主端口多1000，主端口为7777、8888、9999    server 127.0.0.1:8777;server 127.0.0.1:9888;server 127.0.0.1:10999; }server{   listen 9848;        proxy_pass nacos-cluster-grpc;}}

当朋友配置好nginx tcp代理转发后，通过telnet命令

telnet 127.0.0.1 9848

来看是否能正常转发给nacos服务端，经过验证，网络可以连通。接着朋友在微服务项目的nacos配置填写如下地址

spring.cloud.nacos.discovery.server-addr=127.0.0.1:9848 #nginx代理tcp的地址

本来以为万事大吉，结果项目一启动，仍然报

com.alibaba.nacos.api.exception.NacosException: Client not connected, current status:STARTING

于是朋友懵了，啥情况？就来找我交流一下

其实在nacos官网的FAQ就有提到相应的解题思路了

因为我们在nginx配置的代理tcp端口为9848，这个端口可以看成是grpc的端口，因为grpc的端口 = nacos主端口 + 1000，因此我们套这个公式就可以得出，nacos的主端口为 = 9848 - 1000 = 8848，而我们微服务项目配置nacos端口，其实配置是主端口，因此实际上我们配置要写成

spring.cloud.nacos.discovery.server-addr=127.0.0.1:8848 #nginx代理tcp端口 - 1000

配置这个后，果然成功注册。这个思路是官网带给我们的，但作为一个有点追求的程序员应该不会仅仅满足与此，我们可以直接根据控制台报出的异常来获取答案

异常排查过程就省略了，直接贴出关键的解题代码

首先解析主端口号的核心代码

位置在

com.alibaba.nacos.common.remote.client.RpcClient#resolveServerInfo

ServerInfo private RpcClient.ServerInfo resolveServerInfo(String serverAddress) {        Matcher matcher = EXCLUDE_PROTOCOL_PATTERN.matcher(serverAddress);        if (matcher.find()) {            serverAddress = matcher.group(1);        }        String[] ipPortTuple = serverAddress.split(":", 2);        int defaultPort = Integer.parseInt(System.getProperty("nacos.server.port", "8848"));        String serverPort = (String)CollectionUtils.getOrDefault(ipPortTuple, 1, Integer.toString(defaultPort));        return new RpcClient.ServerInfo(ipPortTuple[0], NumberUtils.toInt(serverPort, defaultPort));    }

其次设置grpc端口的核心代码

位置在：

com.alibaba.nacos.common.remote.client.grpc.GrpcClient#connectToServer

端口设置就是在截图圈红部分，然后从this.rpcPortOffset()我们可以发现

public int rpcPortOffset() {        return Integer.parseInt(System.getProperty("nacos.server.grpc.port.offset", String.valueOf(Constants.SDK_GRPC_PORT_DEFAULT_OFFSET)));    }

这个偏移量是可以通过nacos.server.grpc.port.offset进行修改，不修改默认就是1000。因此跟踪源码，我们可以得出另外一种解法。在微服务的nacos配置仍然填代理的nginx 的tcp地址，示例

spring.cloud.nacos.discovery.server-addr=127.0.0.1:9848 #nginx代理tcp的地址

同时启动的时候，加上

-Dnacos.server.grpc.port.offset=0

或者在主启动类硬编码也 可以

    System.setProperty("nacos.server.grpc.port.offset","0");

注： 这边很重要的细节点就是：GRPC port = 主端口 + grpc端口偏移量，这个计算出来的端口值要和nginx代理tcp 端口值相等。

总结

因为朋友用的是目前最新版的nacos2，所以有些问题搜索引擎不是那么好找答案，因此遇到这种问题，最好的解题思路就是官网和相应的github，还有就是源码跟踪了。

后面那个
Client not connected, current status:STARTING，其实还有一种解法，就是把客户端版本调低到1.x版本，因为这个问题本质上是连接不上grpc问题，因此我们可以不用grpc，直接用http就好了，而2.x服务端版本是同时支持http和grpc，因此客户端版本调成1.x，他就是以http的方式和服务端进行交互。不过是不建议这么做，因为你升级了2.x，有一方面就是为高性能，如果把版本降低，那还不如直接使用1.x就好了。

还有文中的那两种解法，我个人是建议不要改偏移量，直接通过主端口 + 1000这种方式去算就好了

附录

本文很多关于nacos2解题思路都是出自官网这篇文章

https://nacos.io/zh-cn/docs/2.0.0-compatibility.html

来源地址：https://blog.csdn.net/kingwinstar/article/details/126409445