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

版本控制与条件更新

版本控制与条件更新

多个客户端同时读写同一个 znode 时,最后一次无条件写入可能覆盖别人刚提交的结果。ZooKeeper 通过节点版本号和条件更新提供乐观并发控制:只有版本仍等于读取时的值,写入才会成功。

学习目标

  • 区分 dataVersion、cversion 与 aversion 的变化来源
  • 使用版本条件执行数据更新,并识别版本冲突
  • 理解“读取版本—计算新值—条件提交”的乐观并发流程

三类版本号不是一回事

每个 znode 都维护多类局部版本。CLI 的 Stat 输出通常使用 dataVersion、cversion、aclVersion,其中 aclVersion 对应 API 中常说的 aversion。

dataVersion 在节点数据每次成功修改后加一,是 setData 或 CLI set -v 做条件更新时最常用的版本。cversion 在当前节点的直接子节点列表发生变化时增加,例如创建或删除一个直接子节点。aversion 则在 ACL 成功修改后增加,条件修改 ACL 时应使用它,而不是 dataVersion。

版本号不是锁,也不会阻止其他客户端读取或尝试写入。它只是让服务端在提交瞬间检查“你基于的旧版本是否仍然有效”。

条件更新如何避免覆盖

假设客户端 A 和 B 都读到 /config 的 dataVersion = 7。A 先按版本 7 提交新数据,成功后版本变为 8;B 随后仍携带期望版本 7 提交,ZooKeeper 会拒绝 B,而不是让它覆盖 A 的结果。

条件更新避免丢失更新的时序

这就是典型的 Compare-And-Set 思路。冲突不是异常状态,而是并发协议中的正常分支;客户端应重新读取最新数据与版本,再决定是否重新计算和重试。

在 zkCli 中验证版本冲突

以下命令在 zkCli.sh 交互环境执行。使用一个尚不存在的测试路径,先创建节点,再读取 Stat,然后用版本 0 更新一次,并故意再次使用旧版本 0。

text
create /anystack-version-demo v1
get -s /anystack-version-demo
set -s -v 0 /anystack-version-demo v2
set -v 0 /anystack-version-demo stale-value

预期输出

text
Created /anystack-version-demo
v1
cZxid = <CZXID>
ctime = <TIME_CREATED>
mZxid = <MZXID_BEFORE>
mtime = <TIME_CREATED>
pZxid = <PZXID>
cversion = 0
dataVersion = 0
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 2
numChildren = 0
cZxid = <CZXID>
ctime = <TIME_CREATED>
mZxid = <MZXID_AFTER>
mtime = <TIME_UPDATED>
pZxid = <PZXID>
cversion = 0
dataVersion = 1
aclVersion = 0
ephemeralOwner = 0x0
dataLength = 2
numChildren = 0
version No is not valid : /anystack-version-demo

<CZXID>、<MZXID_BEFORE>、<MZXID_AFTER>、<PZXID> 和时间占位符会随集群事务历史变化。第一次 set 携带期望版本 0,因此成功并把 dataVersion 推进到 1;第二次仍要求版本 0,服务端发现当前已经是 1,于是拒绝写入。不同客户端版本的错误文案可能略有差异,但都会表达版本不匹配。

冲突后的正确处理

业务代码遇到 BadVersion 后,通常按三个动作处理:重新读取最新数据与 Stat;基于最新数据重新计算目标值;携带新的期望版本再次提交。是否自动重试取决于操作是否可安全重算,不能把旧结果机械地重复写入。

如果业务只需要“无论别人改没改都覆盖”,可以使用不带条件的写入;但配置中心、主节点竞选元数据、配额计数或其他存在读改写过程的场景,更适合保留版本条件。

cversion 主要帮助观察子节点集合是否变化,普通 create/delete 并不把它作为通用的条件参数;ACL 更新则有自己的版本条件,应使用 aversion/aclVersion。把三类版本混用,会导致并发判断看似存在、实际检查错对象。

选择版本条件的原则

先明确你保护的到底是哪一类状态:改节点数据就检查 dataVersion,改 ACL 就检查 aversion,观察子节点结构变化则关注 cversion。乐观并发控制的关键不是“版本越多越安全”,而是每次提交都验证自己真正依赖的那份状态有没有被别人改过。

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

目录与阅读设置

阅读设置

17

记录一个想法

版本控制与条件更新

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

登录哪都通