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

连接状态监听

连接状态监听

连接状态监听的重点不是“打印一条日志”,而是把网络抖动、会话失效和只读连接转换成明确的业务动作。本节用 ConnectionStateListener 识别五种状态,并建立暂停写入、恢复服务和重建会话资源的处理规则。

学习目标

  • 区分 CONNECTED、SUSPENDED、RECONNECTED、LOST 与 READ_ONLY 的语义
  • 使用 ConnectionStateListener 注册全局连接状态回调
  • 根据是否发生过会话丢失决定恢复还是重建临时资源

先把五种状态分清

CONNECTED 只表示当前 CuratorFramework 第一次成功连接。SUSPENDED 表示连接暂时中断,此时会话可能仍然有效,但锁、选主和依赖 ZooKeeper 的写操作都不应继续冒险执行。LOST 则意味着 Curator 判断 ZooKeeper 会话已经过期,旧会话上的临时节点、锁和领导权必须视为失效。

状态 应用侧含义 建议动作
CONNECTED 首次建立可用连接 开放依赖 ZooKeeper 的正常操作
SUSPENDED 连接丢失,但尚不能确认会话过期 暂停写入和依赖锁、领导权的关键任务
RECONNECTED 从挂起、丢失或只读状态重新连通 结合之前是否出现 LOST 决定直接恢复还是重建状态
LOST 会话被判定为已过期 使旧会话资源失效并进入重建流程
READ_ONLY 已进入 ZooKeeper 只读连接 只允许能接受旧数据风险的读取,禁止依赖写入的流程

Curator 连接状态与应用动作

注册监听器并定义恢复动作

下面的完整示例基于 Java 17,并假定项目已经引入 Curator 5.x 的 curator-framework。示例用两个原子变量分别表示“是否允许关键写入”和“此前是否发生过会话丢失”,恢复连接时先重建或校验会话资源,再重新开放关键写入。

java
import java.util.concurrent.TimeUnit;
import java.util.concurrent.atomic.AtomicBoolean;

import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.framework.state.ConnectionState;
import org.apache.curator.retry.ExponentialBackoffRetry;

public class ConnectionStateDemo {
    public static void main(String[] args) throws Exception {
        String connectString = args.length > 0 ? args[0] : "127.0.0.1:2181";
        AtomicBoolean writesEnabled = new AtomicBoolean(false);
        AtomicBoolean sessionLost = new AtomicBoolean(false);

        try (CuratorFramework client = CuratorFrameworkFactory.builder()
                .connectString(connectString)
                .sessionTimeoutMs(15_000)
                .connectionTimeoutMs(5_000)
                .retryPolicy(new ExponentialBackoffRetry(1_000, 3))
                .canBeReadOnly(true)
                .build()) {

            client.getConnectionStateListenable().addListener(
                    (c, state) -> handleState(state, writesEnabled, sessionLost));

            client.start();
            if (!client.blockUntilConnected(10, TimeUnit.SECONDS)) {
                throw new IllegalStateException("ZooKeeper connection timeout");
            }

            System.out.println("ready=" + writesEnabled.get());
            Thread.sleep(30_000);
        }
    }

    private static void handleState(
            ConnectionState state,
            AtomicBoolean writesEnabled,
            AtomicBoolean sessionLost) {

        switch (state) {
            case CONNECTED -> {
                writesEnabled.set(true);
                System.out.println("state=CONNECTED action=enable-writes");
            }
            case SUSPENDED -> {
                writesEnabled.set(false);
                System.out.println("state=SUSPENDED action=pause-critical-work");
            }
            case LOST -> {
                writesEnabled.set(false);
                sessionLost.set(true);
                System.out.println("state=LOST action=invalidate-session-resources");
            }
            case READ_ONLY -> {
                writesEnabled.set(false);
                System.out.println("state=READ_ONLY action=disable-writes");
            }
            case RECONNECTED -> {
                boolean lostBefore = sessionLost.getAndSet(false);
                writesEnabled.set(false);
                if (lostBefore) {
                    rebuildSessionResources();
                } else {
                    revalidateSessionResources();
                }
                writesEnabled.set(true);
                System.out.println("state=RECONNECTED action=resume-after-check");
            }
        }
    }

    private static void rebuildSessionResources() {
        // 真实项目应重新创建临时节点,并重新申请锁或领导权。
        System.out.println("action=rebuild-session-resources");
    }

    private static void revalidateSessionResources() {
        // 未发生 LOST 时也应确认锁、选主等业务前提仍满足。
        System.out.println("action=revalidate-session-resources");
    }
}

健康的 ZooKeeper 集群上首次运行时,最小预期输出如下;监听回调与主线程输出的先后可能因调度略有差异。

text
state=CONNECTED action=enable-writes
ready=true

用前序状态决定恢复级别

应用恢复逻辑应保存“发生了什么”,而不是只看当前枚举值。SUSPENDED 后直接收到 RECONNECTED 时,可以在重新校验必要条件后恢复工作;如果已经收到 LOST,则旧 ZooKeeper 会话已经不能作为任何互斥或临时成员身份的依据。

READ_ONLY 只有在客户端启用了 canBeReadOnly(true) 时才可能出现。它适合明确允许只读降级的场景,但本地业务不能因为“还能读”就把连接当成完全健康,尤其不能执行依赖 ZooKeeper 写入、锁或选主的流程。

验证故障处理是否真的生效

在测试环境中,可在程序运行的 30 秒窗口内短暂停止当前 ZooKeeper 服务或阻断网络,观察 SUSPENDED;若中断持续超过会话超时,还应看到 LOST。服务恢复后会进入 RECONNECTED。验收时重点检查三件事:挂起期间关键写入是否停止、LOST 后旧会话资源是否作废、恢复后是否经过重建或校验再开放业务。

如果系统把 ZooKeeper 用于锁、Leader 选举或临时节点注册,连接状态监听应成为业务状态机的一部分,而不是一个独立的日志回调。这样网络故障才能被转换成可控的暂停、重建与恢复动作。

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

目录与阅读设置

阅读设置

17

记录一个想法

连接状态监听

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

登录哪都通