服务注册与分布式协调 / 系统课时
服务注册与发现
服务注册与发现
本节把服务实例的“在线状态”映射成 ZooKeeper 临时节点:实例启动后登记地址,消费者监听实例目录;会话失效时节点自动删除,消费者重新拉取列表并更新本地路由,从而形成可验证的注册与发现闭环。
学习目标
- 设计持久父节点与临时顺序实例节点的注册结构
- 使用子节点监听感知实例上线、下线并刷新本地列表
- 处理一次性 Watch、会话过期和短时假在线等边界
把实例状态映射到临时节点
服务目录应由持久节点承载,例如 /services/order/instances;每个进程在目录下创建一个临时顺序节点,节点数据只保存发现所需的端点与少量元信息。临时节点归属于创建它的 ZooKeeper 会话,会话过期后由服务端删除,因此不需要额外的“注销表”。
顺序后缀让同一服务的多个实例无需提前协调节点名,也能避免普通固定名称在并发启动时冲突。消费者不应依赖顺序号的业务含义,而应读取所有子节点及其数据,构造自己的可用实例集合。

注册并观察实例变化
前置条件是 ZooKeeper 已启动,并能通过 bin/zkCli.sh -server 127.0.0.1:2181 进入交互会话。下面的片段示例假设 /services 尚不存在,命令在“实例 A”持有的同一个 zkCli 会话中连续执行。
create /services
create /services/order
create /services/order/instances
create -s -e /services/order/instances/instance- 10.0.0.8:8080
ls /services/order/instances预期输出
Created /services
Created /services/order
Created /services/order/instances
Created /services/order/instances/instance-<ID>
[instance-<ID>]<ID> 是 ZooKeeper 生成的顺序后缀,实际值可能不同。此时在另一个 zkCli 会话中给实例目录注册子节点监听。
ls -w /services/order/instances预期输出
[instance-<ID>]保持监听会话不退出,再在“实例 A”会话执行 close 或直接结束该会话。临时节点随会话失效被删除后,监听端会收到 NodeChildrenChanged 事件;不同客户端版本的日志前缀可能不同,但事件路径应指向 /services/order/instances。
正确处理一次性 Watch
ZooKeeper 的普通 Watch 更适合看作“缓存可能失效”的通知,而不是包含完整增量内容的消息。收到子节点变化事件后,消费者必须重新读取整个实例目录,并在这次读取时再次注册 Watch,否则后续变化不会继续通知当前监听。
可靠的消费流程是:启动时读取子节点并注册 Watch,解析各实例端点后原子替换本地路由表;收到 NodeChildrenChanged 后重复这一流程。连接暂时中断时保留最近一次可用快照;若会话已经过期,则重建 ZooKeeper 客户端、重新建立监听并完整拉取一次实例列表。
控制假在线与重复实例
临时节点不会在 TCP 瞬断时立即删除,只有会话真正过期才会消失。因此注册端应在业务实例已具备服务能力后再登记,并为会话超时设置符合故障检测目标的范围;超时过短会放大网络抖动,过长则会延长故障实例从注册表消失的时间。
重连逻辑还要防止“旧会话尚未过期,新会话又完成注册”造成同一端点短暂重复。实例数据中可以带稳定实例标识或启动标识,消费者侧再按业务规则去重。批量上下线时应合并短时间内的刷新,避免每个 Watch 事件都触发昂贵的下游重建。
服务发现的关键不是“监听到了事件”,而是始终把 ZooKeeper 目录当作权威快照:事件只负责提醒重新读取,实例数据负责重建路由,Session 生命周期负责把失效实例从目录中最终清理掉。