服务注册与分布式协调 / 系统课时
连接状态监听
连接状态监听
连接状态监听的重点不是“打印一条日志”,而是把网络抖动、会话失效和只读连接转换成明确的业务动作。本节用 ConnectionStateListener 识别五种状态,并建立暂停写入、恢复服务和重建会话资源的处理规则。
学习目标
- 区分
CONNECTED、SUSPENDED、RECONNECTED、LOST与READ_ONLY的语义 - 使用
ConnectionStateListener注册全局连接状态回调 - 根据是否发生过会话丢失决定恢复还是重建临时资源
先把五种状态分清
CONNECTED 只表示当前 CuratorFramework 第一次成功连接。SUSPENDED 表示连接暂时中断,此时会话可能仍然有效,但锁、选主和依赖 ZooKeeper 的写操作都不应继续冒险执行。LOST 则意味着 Curator 判断 ZooKeeper 会话已经过期,旧会话上的临时节点、锁和领导权必须视为失效。
| 状态 | 应用侧含义 | 建议动作 |
|---|---|---|
CONNECTED |
首次建立可用连接 | 开放依赖 ZooKeeper 的正常操作 |
SUSPENDED |
连接丢失,但尚不能确认会话过期 | 暂停写入和依赖锁、领导权的关键任务 |
RECONNECTED |
从挂起、丢失或只读状态重新连通 | 结合之前是否出现 LOST 决定直接恢复还是重建状态 |
LOST |
会话被判定为已过期 | 使旧会话资源失效并进入重建流程 |
READ_ONLY |
已进入 ZooKeeper 只读连接 | 只允许能接受旧数据风险的读取,禁止依赖写入的流程 |

注册监听器并定义恢复动作
下面的完整示例基于 Java 17,并假定项目已经引入 Curator 5.x 的 curator-framework。示例用两个原子变量分别表示“是否允许关键写入”和“此前是否发生过会话丢失”,恢复连接时先重建或校验会话资源,再重新开放关键写入。
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 集群上首次运行时,最小预期输出如下;监听回调与主线程输出的先后可能因调度略有差异。
state=CONNECTED action=enable-writes
ready=true用前序状态决定恢复级别
应用恢复逻辑应保存“发生了什么”,而不是只看当前枚举值。SUSPENDED 后直接收到 RECONNECTED 时,可以在重新校验必要条件后恢复工作;如果已经收到 LOST,则旧 ZooKeeper 会话已经不能作为任何互斥或临时成员身份的依据。
READ_ONLY 只有在客户端启用了 canBeReadOnly(true) 时才可能出现。它适合明确允许只读降级的场景,但本地业务不能因为“还能读”就把连接当成完全健康,尤其不能执行依赖 ZooKeeper 写入、锁或选主的流程。
验证故障处理是否真的生效
在测试环境中,可在程序运行的 30 秒窗口内短暂停止当前 ZooKeeper 服务或阻断网络,观察 SUSPENDED;若中断持续超过会话超时,还应看到 LOST。服务恢复后会进入 RECONNECTED。验收时重点检查三件事:挂起期间关键写入是否停止、LOST 后旧会话资源是否作废、恢复后是否经过重建或校验再开放业务。
如果系统把 ZooKeeper 用于锁、Leader 选举或临时节点注册,连接状态监听应成为业务状态机的一部分,而不是一个独立的日志回调。这样网络故障才能被转换成可控的暂停、重建与恢复动作。