9.4.6 服务上下线与实例状态管理

在服务注册与发现体系中，服务上下线与实例状态管理决定了流量是否能被正确引导至健康实例。Nacos通过实例状态、健康检查、心跳与订阅推送协同完成实例生命周期管理，确保服务治理的稳定性与可观测性。

原理草图：上下线与状态流转#

实例生命周期与状态模型#

UP/健康：实例可接收流量，客户端订阅列表包含该实例。
DOWN/不健康：实例存在但不可接收流量，通常由健康检查或心跳超时触发。
DISABLED/禁用：手动禁用实例，不参与服务发现与负载均衡。
OUT/下线：实例被注销或不可达，注册中心移除实例信息。

环境与安装验证（示例）#

以已部署的 Nacos 为前提，先确认服务可用：

# 1) 检查 Nacos Server 端口（默认 8848）
ss -lntp | grep 8848

# 2) 健康检查
curl -s "http://127.0.0.1:8848/nacos/v1/console/health/liveness" | jq .
# 预期：{"status":"UP"}

服务上线流程（OpenAPI 示例）#

示例以临时实例注册为例（ephemeral=true）：

# 变量
NACOS_ADDR="127.0.0.1:8848"
NAMESPACE="public"
SERVICE="order-svc"
IP="10.0.0.21"
PORT="8080"
CLUSTER="cluster-a"

# 1) 注册实例
curl -s -X POST "http://${NACOS_ADDR}/nacos/v1/ns/instance" \
  -d "serviceName=${SERVICE}" \
  -d "ip=${IP}" \
  -d "port=${PORT}" \
  -d "clusterName=${CLUSTER}" \
  -d "namespaceId=${NAMESPACE}" \
  -d "weight=1" \
  -d "enabled=true" \
  -d "ephemeral=true"

# 2) 查询实例列表
curl -s "http://${NACOS_ADDR}/nacos/v1/ns/instance/list?serviceName=${SERVICE}&namespaceId=${NAMESPACE}" | jq .
# 预期：实例状态 healthy=true，enabled=true

服务下线流程（优雅下线示例）#

# 1) 先将权重置 0，停止新流量
curl -s -X PUT "http://${NACOS_ADDR}/nacos/v1/ns/instance" \
  -d "serviceName=${SERVICE}" \
  -d "ip=${IP}" \
  -d "port=${PORT}" \
  -d "namespaceId=${NAMESPACE}" \
  -d "weight=0"

# 2) 禁用实例（可选，维护时用）
curl -s -X PUT "http://${NACOS_ADDR}/nacos/v1/ns/instance" \
  -d "serviceName=${SERVICE}" \
  -d "ip=${IP}" \
  -d "port=${PORT}" \
  -d "namespaceId=${NAMESPACE}" \
  -d "enabled=false"

# 3) 注销实例（彻底下线）
curl -s -X DELETE "http://${NACOS_ADDR}/nacos/v1/ns/instance" \
  -d "serviceName=${SERVICE}" \
  -d "ip=${IP}" \
  -d "port=${PORT}" \
  -d "namespaceId=${NAMESPACE}"

心跳与健康检查策略（配置示例）#

客户端心跳参数（以 Java 客户端为例）：

# application.yaml
spring:
  cloud:
    nacos:
      discovery:
        server-addr: 127.0.0.1:8848
        heartbeat-interval: 5000      # 心跳间隔(ms)
        heartbeat-timeout: 15000      # 心跳超时(ms)
        ip-delete-timeout: 30000      # 删除超时(ms)

说明：心跳间隔过小会放大网络抖动，过大则故障感知变慢，应结合业务 SLA 调整。

权重与状态联动示例（灰度放量）#

# 先以 0 权重注册，不接流量
curl -s -X POST "http://${NACOS_ADDR}/nacos/v1/ns/instance" \
  -d "serviceName=${SERVICE}" -d "ip=${IP}" -d "port=${PORT}" \
  -d "weight=0" -d "enabled=true" -d "ephemeral=true"

# 逐步放量：0 -> 0.2 -> 0.5 -> 1
for w in 0.2 0.5 1; do
  curl -s -X PUT "http://${NACOS_ADDR}/nacos/v1/ns/instance" \
    -d "serviceName=${SERVICE}" -d "ip=${IP}" -d "port=${PORT}" \
    -d "weight=${w}"
  sleep 30
done

运维与排错要点（命令+定位）#

实例列表与健康状态不一致：

# 控制台与 API 对比
curl -s "http://${NACOS_ADDR}/nacos/v1/ns/instance/list?serviceName=${SERVICE}" | jq '.hosts[]|{ip,port,healthy,enabled,weight}'

心跳丢失/实例变 DOWN：

# 查看 Nacos 日志
tail -f /opt/nacos/logs/naming.log | grep -i "heartbeat"
# 检查网络抖动
ping -c 5 ${NACOS_ADDR%:*}

下线不生效（客户端仍访问）：

# 检查客户端订阅连接
curl -s "http://${NACOS_ADDR}/nacos/v1/ns/instance/list?serviceName=${SERVICE}" | jq '.hosts[]|{ip,port,enabled,healthy}'
# 客户端需确认本地缓存刷新周期与订阅是否断开

练习与验证#

注册一个临时实例（权重 1），确认实例为 UP。
将权重置为 0，观察客户端调用是否停止命中该实例。
禁用实例（enabled=false），确认服务发现列表中该实例不再参与负载。
注销实例，验证其从列表消失并且控制台无该实例记录。
人为断开网络 20 秒，观察健康状态是否变为 DOWN。