服务注册与分布式协调 / 系统课时

服务注册与健康维护

服务注册与健康维护

本课实现服务实例注册和实例列表监听。你将使用临时节点表达会话存活,处理新会话建立后的节点恢复,支持元数据更新,并让调用方通过本地缓存获得稳定的实例视图。

学习目标

  • 创建可随新会话恢复的服务实例临时节点
  • 安全更新实例元数据并监听实例列表变化
  • 区分会话健康与业务健康

注册实例节点

直接调用 create 创建临时节点后,应用还要自行处理 LOST 后重建。Curator 的 PersistentEphemeralNode recipe 可以维护目标临时节点,并在新会话建立后重新创建。

下面是片段示例,依赖共享 CuratorFramework,且父路径已由初始化程序创建。实例 ID 必须在同一服务内唯一。

java
import java.nio.charset.StandardCharsets;
import java.util.concurrent.TimeUnit;
import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.recipes.nodes.PersistentEphemeralNode;

public final class ServiceRegistration implements AutoCloseable {
    private final PersistentEphemeralNode node;

    public ServiceRegistration(
            CuratorFramework client,
            String serviceName,
            String instanceId,
            String metadataJson) {
        String path = "/services/" + serviceName
                + "/instances/" + instanceId;
        this.node = new PersistentEphemeralNode(
                client,
                PersistentEphemeralNode.Mode.EPHEMERAL,
                path,
                metadataJson.getBytes(StandardCharsets.UTF_8));
    }

    public void start() throws Exception {
        node.start();
        boolean created = node.waitForInitialCreate(10, TimeUnit.SECONDS);
        if (!created) {
            throw new IllegalStateException("Service node create timeout");
        }
    }

    public void update(String metadataJson) throws Exception {
        node.setData(metadataJson.getBytes(StandardCharsets.UTF_8));
    }

    @Override
    public void close() throws Exception {
        node.close();
    }
}

预期行为

text
启动后创建 /services/<SERVICE_NAME>/instances/<INSTANCE_ID>
短暂断线且旧会话恢复时,原临时节点仍有效
会话 LOST 后建立新会话时,recipe 重新创建临时节点
调用 close 后,注册节点被关闭并最终从实例列表消失

服务注册、断线恢复与实例监听时序

维护实例列表缓存

消费者不应每次请求都调用 getChildren。可使用 CuratorCache 监听 /services/<SERVICE_NAME>/instances,把事件转换为不可变的本地实例列表。回调中只完成解析、校验和原子替换,不执行慢网络调用。

监听事件可能合并、延迟或在重连后重新同步,因此业务逻辑应以“当前完整视图”为准,而不是把每个事件当作精确一次的业务消息。需要强一致通知的场景应使用消息系统,而不是依赖 Watch 计数。

更新元数据

实例地址、权重或状态变化时,可更新同一实例节点数据。数据应包含 schemaVersion,消费者先校验字段再替换缓存;解析失败时保留旧视图并上报告警。

更新频率要受控。把每秒变化的负载、请求数或心跳写入 ZooKeeper 会制造大量写入和 Watch 事件。动态负载更适合指标系统,注册节点只保存低频、用于发现的元数据。

健康语义与摘流

临时节点存在只说明 ZooKeeper 会话仍存活,不证明业务线程、数据库或下游依赖健康。调用方仍需执行连接失败重试、熔断或业务探活。

应用准备下线时,应先从流量入口摘除或把状态改为 DRAINING,等待在途请求完成,再关闭注册节点。直接杀进程虽然最终会删除临时节点,但在会话超时窗口内,调用方仍可能看到旧实例。

验证恢复能力

启动两个实例后,实例缓存应包含两个唯一 ID。停止一个实例并等待其会话过期,其他客户端应移除它;重新启动后节点恢复,列表重新加入,但不能出现同一 ID 的重复节点。

还应模拟短暂网络断开,确认未达到会话超时时不会无意义地删除和重建节点;达到 LOST 后,注册组件能在新会话中恢复,并使消费者最终得到与 ZooKeeper 一致的完整列表。

本课总结

  • 服务注册使用临时节点,PersistentEphemeralNode 负责跨新会话重建
  • 实例列表应通过本地缓存消费,Watch 只触发状态同步
  • 会话健康不等于业务健康,下线流程需要先摘流再关闭注册

下一课预告

下一课将实现不可变配置版本、current 指针监听、本地缓存切换以及校验失败和回滚处理。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

服务注册与健康维护

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通