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

版本化更新

版本化更新

ZooKeeper 的 setData 可以把 Stat.version 当作写入前置条件:只有节点仍处于你读到的版本时更新才成功。这样多个客户端同时修改同一 znode 时,旧客户端不会静默覆盖新数据,而是得到明确的版本冲突。

学习目标

  • 读懂 Stat.version 与 setData 条件写入的关系。
  • 用版本号实现一次完整的“读取、修改、冲突、重试”流程。
  • 正确处理 BadVersionException,避免无条件覆盖并发更新。

版本号就是写入前置条件

每次成功执行 setData,znode 的数据版本 Stat.version 都会递增。客户端先读取数据与版本,再把该版本传给 setData(path, data, version);服务端只有在当前版本仍等于期望版本时才接受写入。传 -1 表示忽略版本检查,因此不适合需要防止丢失更新的写路径。

ZooKeeper 版本化条件写入与冲突重试

这是一种典型的乐观并发控制:平时不加锁,真正写入时才验证“我基于的旧状态是否仍然有效”。如果不一致,客户端必须重新读取,而不是把旧计算结果直接再写一次。

用条件写入阻止相互覆盖

下面的程序用一个临时 znode 模拟两个写入者:先保存版本 0,第一次更新成功后,第二次仍拿旧版本 0 写入,因此必然收到 BadVersionException。随后重新读取最新版本并再次提交。

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

public class VersionedUpdateDemo {
    public static void main(String[] args) throws Exception {
        String connectString = args.length > 0 ? args[0] : "127.0.0.1:2181";
        CountDownLatch connected = new CountDownLatch(1);

        try (ZooKeeper zk = new ZooKeeper(connectString, 5000, event -> {
            if (event.getState() == org.apache.zookeeper.Watcher.Event.KeeperState.SyncConnected) {
                connected.countDown();
            }
        })) {
            if (!connected.await(5, TimeUnit.SECONDS)) {
                throw new IllegalStateException("ZooKeeper connection timed out");
            }

            String path = "/version-demo-" + UUID.randomUUID();
            zk.create(path, "v0".getBytes(StandardCharsets.UTF_8),
                    ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);

            Stat firstRead = new Stat();
            zk.getData(path, false, firstRead);
            System.out.println("initial version=" + firstRead.getVersion());

            // 模拟写入者 A:使用刚读取到的版本做条件更新。
            Stat afterA = zk.setData(path, "writer-a".getBytes(StandardCharsets.UTF_8),
                    firstRead.getVersion());
            System.out.println("writer-a version=" + afterA.getVersion());

            try {
                // 模拟写入者 B:仍持有旧版本,服务端必须拒绝这次覆盖。
                zk.setData(path, "writer-b".getBytes(StandardCharsets.UTF_8),
                        firstRead.getVersion());
            } catch (KeeperException.BadVersionException e) {
                System.out.println("writer-b rejected: staleVersion=" + firstRead.getVersion());
            }

            Stat latest = new Stat();
            zk.getData(path, false, latest);
            Stat afterRetry = zk.setData(path, "writer-b-recomputed".getBytes(StandardCharsets.UTF_8),
                    latest.getVersion());
            System.out.println("retry version=" + afterRetry.getVersion());

            zk.delete(path, afterRetry.getVersion());
        }
    }
}

预期输出

text
initial version=0
writer-a version=1
writer-b rejected: staleVersion=0
retry version=2

临时节点名每次运行都不同,但版本变化应保持上述顺序。若在共享测试环境中还有其他客户端修改同一路径,版本号可能继续递增。

冲突后要重新计算

捕获 BadVersionException 后,正确动作是重新读取最新数据与 Stat,再基于新数据重新计算业务结果,并用新版本提交。直接把同一份旧结果循环重试,只会重复失败;把版本改成 -1 虽然能写进去,却重新引入“后写覆盖先写”的风险。

实际业务还应限制重试次数,并区分 NoNodeException、连接中断和会话过期等错误。节点被删除并重新创建后,不能把旧 Stat 当成新节点的可靠身份,应重新获取完整状态再决定是否更新。

什么时候使用版本化更新

配置值、任务状态、轻量元数据等“读后改写”场景很适合使用版本条件。它解决的是并发覆盖,不是跨多个 znode 的事务一致性;如果一次业务变更必须同时校验并修改多个节点,应考虑 ZooKeeper 的 multi 操作配合版本条件,而不是靠多个独立 setData 拼接。

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

目录与阅读设置

阅读设置

17

记录一个想法

版本化更新

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

登录哪都通