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

连接状态与异常处理

连接状态与异常处理

ZooKeeper 客户端会自动重连,但“自动重连”不等于所有失败都能直接重试。本课把连接状态与 ConnectionLoss、SessionExpired、NodeExists、BadVersion 分开处理,建立可恢复、可验证的异常处理顺序。

学习目标

  • 区分临时断连、会话失效与业务写冲突
  • 为四类常见 KeeperException 选择正确的恢复动作
  • 通过 Watcher 状态和读回验证避免盲目重试写操作

先判断连接状态

创建 ZooKeeper 对象只会启动异步连接,真正建立会话后才会收到 SyncConnected。运行期间若收到 Disconnected,当前没有连接到 ensemble,但只要会话尚未过期,客户端仍会尝试连接其他服务器;恢复后可继续使用同一实例。

Expired 则不同:服务端已经判定会话失效,旧 ZooKeeper 实例不能继续用于 API 调用,应用必须重新创建客户端,并重建依赖该会话的临时节点或业务状态。AuthFailed 也应按不可恢复状态处理。若启用了只读客户端,ConnectedReadOnly 期间只能执行读取。

ZooKeeper 客户端状态与异常恢复流程

四类异常不要统一重试

异常 含义 推荐动作
ConnectionLoss 请求或响应期间连接中断,写入结果可能未知 等待重连,先读回业务状态,再决定是否重试
SessionExpired 会话已失效 丢弃旧客户端,创建新会话并恢复临时状态
NodeExists 创建固定路径时节点已存在 判断它是否已经是目标结果;不是则进入冲突处理
BadVersion 乐观锁版本不匹配 重新读取数据和版本,重新计算后再提交

最危险的错误是把 ConnectionLoss 当成普通失败。服务端可能已经执行写入,只是客户端没收到响应。固定路径、可读回验证的幂等写比较容易恢复;顺序节点或带外部副作用的操作若直接重试,可能产生重复结果。

用代码区分异常路径

下面程序假定 127.0.0.1:2181 可访问,项目已依赖 org.apache.zookeeper:zookeeper:3.9.5。它先重复创建同一路径触发 NodeExists,再故意用错误版本触发 BadVersion;通用写方法同时演示 ConnectionLoss 与 SessionExpired 的处理入口。

java
import java.nio.charset.StandardCharsets;
import java.util.Arrays;
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
import org.apache.zookeeper.CreateMode;
import org.apache.zookeeper.KeeperException;
import org.apache.zookeeper.Watcher.Event.KeeperState;
import org.apache.zookeeper.ZooDefs;
import org.apache.zookeeper.ZooKeeper;
import org.apache.zookeeper.data.Stat;

public class ZkErrorHandlingDemo {
    private static final String PATH = "/error-demo";

    public static void main(String[] args) throws Exception {
        CountDownLatch connected = new CountDownLatch(1);

        try (ZooKeeper zk = new ZooKeeper("127.0.0.1:2181", 10_000, event -> {
            KeeperState state = event.getState();
            System.out.println("state=" + state);
            if (state == KeeperState.SyncConnected) {
                connected.countDown();
            }
        })) {
            if (!connected.await(5, TimeUnit.SECONDS)) {
                throw new IllegalStateException("ZooKeeper connection timeout");
            }

            Stat old = zk.exists(PATH, false);
            if (old != null) {
                zk.delete(PATH, old.getVersion());
            }

            zk.create(PATH, bytes("v1"), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);

            try {
                zk.create(PATH, bytes("duplicate"), ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);
            } catch (KeeperException.NodeExistsException e) {
                System.out.println("create=NodeExists");
                System.out.println("existing=" + text(zk.getData(PATH, false, null)));
            }

            Stat stat = new Stat();
            zk.getData(PATH, false, stat);

            try {
                zk.setData(PATH, bytes("v2"), stat.getVersion() + 1);
            } catch (KeeperException.BadVersionException e) {
                System.out.println("set=BadVersion");
            }

            safeSet(zk, PATH, bytes("v2"));
            System.out.println("value=" + text(zk.getData(PATH, false, null)));
        }
    }

    private static void safeSet(ZooKeeper zk, String path, byte[] target) throws Exception {
        for (int attempt = 1; attempt <= 3; attempt++) {
            try {
                Stat stat = new Stat();
                byte[] current = zk.getData(path, false, stat);
                if (Arrays.equals(current, target)) {
                    return;
                }
                zk.setData(path, target, stat.getVersion());
                return;
            } catch (KeeperException.BadVersionException e) {
                // 其他客户端先更新了节点:下一轮重新读取数据与版本。
            } catch (KeeperException.ConnectionLossException e) {
                // 结果可能未知:下一轮先读回目标状态,而不是直接重复写。
                Thread.sleep(200);
            } catch (KeeperException.SessionExpiredException e) {
                throw new IllegalStateException("session expired: recreate ZooKeeper client", e);
            }
        }
        throw new IllegalStateException("write failed after retries");
    }

    private static byte[] bytes(String value) {
        return value.getBytes(StandardCharsets.UTF_8);
    }

    private static String text(byte[] value) {
        return new String(value, StandardCharsets.UTF_8);
    }
}

一次干净运行的预期输出如下;首次连接前后可能还出现其他连接状态日志。

text
state=SyncConnected
create=NodeExists
existing=v1
set=BadVersion
value=v2

给重试加上边界

异常处理应先问三个问题:当前会话是否仍有效、上一次写入结果是否确定、这次操作是否幂等。只有三个答案都允许时,才进入有限次数的自动重试。

BadVersion 不能靠原参数循环重试,因为版本已经过期;必须重新读数据再做业务判断。NodeExists 也不应一律忽略,只有确认现有节点正是期望结果时才能当作幂等成功。SessionExpired 更不能在旧实例上继续重试。

稳定的 ZooKeeper 客户端不是“捕获异常然后 sleep”,而是把临时断连、结果未知、并发冲突和会话失效分别建模,再通过读回验证和有限重试闭环。

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

目录与阅读设置

阅读设置

17

记录一个想法

连接状态与异常处理

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

登录哪都通