06、Nacos Discovery:职责与 SDK 注册发现实验

说明 Nacos Discovery 的职责,并用 Nacos 2.3.2 Java SDK 验证注册、查询与下线;不验证 Spring 自动注册或业务健康。

简明结论

服务注册成功只说明注册中心保存了实例信息,不能证明业务端口能响应,也不能证明消费者的调用和负载均衡已配置正确。

服务注册成功只说明注册中心保存了实例信息,不能证明业务端口能响应,也不能证明消费者的调用和负载均衡已配置正确。

Discovery 的职责

Spring Cloud Alibaba Nacos Discovery 把 Spring Cloud 注册发现模型接入 Nacos。原文只有能力介绍,没有依赖、配置或调用步骤,不能称为完整快速接入。实际 Spring 工程先参考 固定 BOM 与依赖配置;下面单独验证官方 Java SDK 的注册、查询和下线,不冒充 Spring starter 自动注册实验。

可复现实验

固定 Nacos Server/Client 2.3.2、JDK 21;使用自己新建的 standalone 服务。服务名随机生成,PHASE4 分组仅用于测试,19091 是注册信息中的示例端口,没有启动业务服务。

采用 完整实验 POM,将以下测试存为 src/test/java/site/DiscoveryExampleTest.java。在能连接自己测试 Nacos 的环境执行 mvn -Dtest=DiscoveryExampleTest test。仓库验证脚本在 Nacos 的隔离网络命名空间内运行 Maven,不开放宿主端口。

package site;

import com.alibaba.nacos.api.NacosFactory;
import com.alibaba.nacos.api.naming.NamingService;
import org.junit.jupiter.api.Test;
import java.util.UUID;
import static org.junit.jupiter.api.Assertions.*;

class DiscoveryExampleTest {
  @Test void discovery() throws Exception {
    NamingService naming = NacosFactory.createNamingService("127.0.0.1:8848");
    String service = "phase4-" + UUID.randomUUID();
    try {
      naming.registerInstance(service, "PHASE4", "127.0.0.1", 19091);
      boolean registered = false;
      for (int i = 0; i < 50; i++) {
        registered = naming.getAllInstances(service, "PHASE4", false).stream()
          .anyMatch(x -> x.getPort() == 19091);
        if (registered) break;
        Thread.sleep(100);
      }
      assertTrue(registered);
      naming.deregisterInstance(service, "PHASE4", "127.0.0.1", 19091);
      boolean removed = false;
      for (int i = 0; i < 50; i++) {
        removed = naming.getAllInstances(service, "PHASE4", false).isEmpty();
        if (removed) break;
        Thread.sleep(100);
      }
      assertTrue(removed);
      System.out.println("registered=true; deregistered=true; business-health-not-tested=true");
    } finally {
      naming.deregisterInstance(service, "PHASE4", "127.0.0.1", 19091);
      naming.shutDown();
    }
  }
}

预期关键输出 registered=true; deregistered=true; business-health-not-tested=true。查询使用不订阅的服务列表,并有限次等待传播结果,不假定所有更新瞬时可见。

验证边界

该实验没有校验业务健康、Spring 自动注册、消费者调用、网关、鉴权或 Nacos 集群。host/port 和健康信息属于注册元数据,不能替代从消费者网络发起真实请求。后续配置管理可阅读 两个 Nacos 配置的导入实验。