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

Watch 丢失与重复处理

Watch 丢失与重复处理

本课解决 Watch 没有触发、只触发一次或业务重复处理的问题。核心做法不是把事件当作完整消息流,而是把它当作“状态可能变化”的提示,每次触发后重新读取当前数据、重新注册监听并幂等更新本地状态。

学习目标

  • 理解传统 Watch 的一次性与异步语义
  • 识别断线窗口和重复处理的根因
  • 实现重新读取、重新注册和版本去重

Watch 为什么看起来会丢

传统 Watch 是一次性触发器。getData、exists 或 getChildren 注册后,匹配变化只触发一次;收到事件后若没有重新执行读取并注册,就不会继续收到后续变化。

断线期间事件可能已经发生。客户端重连后不能只等待下一条 Watch,而应主动读取当前状态并重新注册。Watch 只保证变化通知的顺序关系,不保证把每一次中间状态都当作独立业务消息交付。

ZooKeeper Watch 重新读取与幂等处理流程

可靠处理模型

可靠模型包含四步:收到连接成功或节点事件;提交一次状态校准任务;读取当前值并同时注册新 Watch;仅当版本比本地版本新时应用数据。事件回调必须快速返回,实际 I/O 和业务处理放入独立执行器。

下面是片段示例,依赖已建立的 ZooKeeper zk、业务路径 path 和线程池 executor。它展示关键控制逻辑,不是完整应用入口。

java
final class ConfigWatcher implements Watcher {
    private final ZooKeeper zk;
    private final String path;
    private final Executor executor;
    private final AtomicInteger appliedVersion = new AtomicInteger(-1);
    private final AtomicBoolean refreshing = new AtomicBoolean(false);

    ConfigWatcher(ZooKeeper zk, String path, Executor executor) {
        this.zk = zk;
        this.path = path;
        this.executor = executor;
    }

    @Override
    public void process(WatchedEvent event) {
        if (event.getState() == Event.KeeperState.SyncConnected
                || event.getType() != Event.EventType.None) {
            refreshAsync();
        }
    }

    void refreshAsync() {
        if (!refreshing.compareAndSet(false, true)) {
            return;
        }
        executor.execute(() -> {
            try {
                Stat stat = new Stat();
                byte[] data = zk.getData(path, this, stat);
                int version = stat.getVersion();
                if (version > appliedVersion.get()) {
                    applyConfig(data);
                    appliedVersion.set(version);
                }
            } catch (KeeperException.NoNodeException e) {
                try {
                    zk.exists(path, this);
                } catch (Exception ignored) {
                    // 下一次连接事件或定时校准会再次尝试
                }
            } catch (Exception e) {
                // 记录错误,并由重连事件或定时任务再次校准
            } finally {
                refreshing.set(false);
            }
        });
    }

    private void applyConfig(byte[] data) {
        System.out.println(new String(data, StandardCharsets.UTF_8));
    }
}

预期行为:同一时刻只运行一个刷新任务;每次成功读取时重新注册 Watch;相同或更旧版本不会重复应用。若节点暂时不存在,则在 exists 上注册监听。

text
仅当 znode 的 stat.version 增加时输出并应用新配置。

重复处理从哪里产生

重复通常来自重连后主动校准与 Watch 事件同时到达、多个线程并发刷新、业务重试,或同一配置内容被写入多个版本。解决办法是以 Stat.version、业务版本号或内容哈希作为幂等键,而不是假设事件只到一次。

若业务要求每一条变更都不可丢失,传统 Watch 不适合作为消息队列。应把变更写入顺序节点、数据库事件表或专业消息系统,Watch 只用于提示消费者尽快拉取。

增加周期校准

即使 Watch 逻辑正确,也建议增加低频全量校准,例如每 30~60 秒读取一次关键路径。周期校准不是替代 Watch,而是修复未知异常、线程退出或短暂错误造成的本地状态偏差。

本课总结

  • 传统 Watch 只触发一次,收到事件后必须重新读取并注册
  • 断线重连后应读取当前最终状态,不依赖补发所有中间事件
  • 使用版本号、业务版本或哈希实现幂等,不能把 Watch 当消息队列

下一课预告

下一课将排查集群无法形成多数派的问题,重点检查成员身份、选举通信、磁盘和节点状态。

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

目录与阅读设置

阅读设置

17

记录一个想法

Watch 丢失与重复处理

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

登录哪都通