Spring Cloud Alibaba 2022.0.0.0-RC1下Nacos 2.x客户端连接异常排查

1. GRPC端口未映射：Nacos 2.x默认采用GRPC协议实现客户端与服务端通信，9848是GRPC主端口（由HTTP端口8848加1000推导而来）。你用Docker部署Nacos时如果只映射了8848端口，未开放9848端口，客户端就无法通过GRPC连接服务端。
2. 客户端配置未生效：你配置的Nacos服务端IP/端口可能没被正确加载，客户端会 fallback 到默认值127.0.0.1:8848，进而尝试连接本地9848端口。常见原因包括配置项写错、用application.yml而非bootstrap.yml（Nacos配置需在Spring Boot启动初期加载，必须用bootstrap文件）。
3. 网络/防火墙拦截：宿主机防火墙或Docker网络策略阻止了9848端口的通信，导致连接被拒绝。

1. 补全Docker Nacos端口映射 #

启动Nacos容器时，必须映射GRPC相关端口，命令示例：

docker run -d \
  -p 8848:8848 \
  -p 9848:9848 \
  -p 9849:9849 \
  -e MODE=standalone \
  nacos/nacos-server:v2.3.0

• 8848：HTTP端口
• 9848：客户端与服务端通信的GRPC主端口
• 9849：服务端集群间通信的GRPC端口（单机模式也建议映射）

2. 修正客户端配置 #

检查项目的bootstrap.yml（禁止用application.yml），确保配置正确：

spring:
  cloud:
    nacos:
      server-addr: 你的Docker宿主机IP:8848  # 替换为宿主机实际IP，不要用127.0.0.1（除非容器用host网络）
      config:
        enabled: true
      discovery:
        enabled: true

注意：Nacos配置需要在Spring Boot启动初期加载，application.yml加载时机晚于启动流程，会导致配置不生效。

3. 验证网络连通性 #

在运行客户端的机器上执行以下命令，确认9848端口可访问：

telnet 你的Docker宿主机IP 9848
# 或者用nc命令（若已安装）
nc -zv 你的Docker宿主机IP 9848

若端口不通，检查宿主机防火墙是否开放9848端口，或Docker容器的网络配置是否允许外部访问。

4. 手动指定GRPC端口（可选） #

若Nacos服务端的GRPC端口不是默认的9848，可在客户端配置中显式指定：

spring:
  cloud:
    nacos:
      server-addr: 你的Docker宿主机IP:8848
      config:
        grpc-port: 你的自定义GRPC端口
      discovery:
        grpc-port: 你的自定义GRPC端口

内容的提问来源于stack exchange，提问作者alley