服务注册与分布式协调 / 系统课时
注册并识别第一个服务实例
注册并识别第一个服务实例
这一课把注册结果真正跑通:启动一个名为 inventory-service 的实例,再分别从 Nacos 控制台和查询接口确认服务名、实例地址与健康状态,避免只凭“应用启动成功”就判断注册成功。
学习目标
- 启动服务并区分“服务名”和“实例地址”两个层级
- 从 Nacos 控制台确认实例是否进入正确服务
- 通过 Nacos 查询接口复核实例地址与
healthy状态
准备可注册的实例配置
本课示例假定应用已经接入 Nacos Discovery Starter。为保证可以独立跟做,核心配置如下,保存为 src/main/resources/application.yml:
server:
port: 8081
spring:
application:
name: inventory-service
cloud:
nacos:
discovery:
server-addr: ${NACOS_SERVER_ADDR:127.0.0.1:8848}inventory-service 是服务名,<IP>:8081 才是某个运行实例的地址。多启动一个副本时,服务名通常保持不变,而 IP 或端口应不同。
启动应用并等待注册
确认 Nacos Server 已经运行后,在项目根目录启动 Spring Boot 应用:
mvn spring-boot:run预期输出:
Started <APPLICATION_CLASS> in <TIME> seconds<APPLICATION_CLASS> 与 <TIME> 取决于项目和机器。应用进程应持续运行;如果随后日志反复出现 Nacos 连接或注册错误,就不能把这条 Started 日志当成“注册成功”的证据。
在控制台核对服务与实例
打开当前环境的 Nacos 控制台,在服务管理的服务列表中搜索 inventory-service。进入服务详情后,至少核对服务名、实例 IP、端口 8081 和健康状态;如果使用了自定义命名空间或分组,还要确认当前控制台视图与客户端配置一致。

如果控制台里有服务名却没有实例,说明“服务定义存在”不等于“当前应用实例已注册”。如果实例 IP 与预期不同,先检查宿主机、容器或多网卡环境下客户端实际选择的网卡地址,不要直接在控制台手工改记录掩盖问题。
用查询接口做第二次确认
Nacos 3.x 可以通过客户端 OpenAPI 查询指定服务的实例。下面使用默认 public 命名空间和 DEFAULT_GROUP;如果部署启用了鉴权,需要按该环境的认证方式补充凭据。
curl -sS "http://127.0.0.1:8848/nacos/v3/client/ns/instance/list?serviceName=inventory-service"预期结果:
HTTP 请求成功,响应 code 为 0;data 实例列表至少包含 1 项,其中 port 为 8081,healthy 为 true,ip 为当前实例实际注册地址 <IP>。控制台与接口看到的服务名、IP、端口应能互相对上。healthy: true 表示注册中心当前把该实例视为健康实例,但它不能替代业务接口、数据库依赖或下游依赖的应用级健康检查。
注册结果不一致时按顺序排查
服务完全不存在时,先看应用日志中的 Nacos 连接与注册异常,再确认 spring.application.name、server-addr 和运行环境网络。服务存在但查不到当前实例时,继续核对命名空间、分组以及应用是否仍在运行。
如果实例出现后很快消失,优先判断应用进程是否退出、网络是否中断,或客户端与 Nacos Server 的连接是否持续失败。只有当“控制台记录”和“查询接口结果”都能稳定看到同一个 <IP>:8081 且状态健康时,才算完成了第一个实例的注册验证。