服务注册与分布式协调 / 系统课时
多操作事务
多操作事务
本课解决多个节点操作之间可能只成功一部分的问题。你将使用 multi 把版本检查、数据更新和审计节点创建提交为一个原子事务,并学会区分业务冲突、连接异常与整体回滚。
学习目标
- 理解
multi的原子性与顺序执行语义 - 使用版本检查保护并发更新
- 正确处理失败结果与不确定提交状态
为什么需要多操作事务
单独调用 setData、create 和 delete 时,每次调用都是独立事务。若第二步失败,第一步已经生效,应用必须自行补偿。multi 将多个操作作为一个请求提交:全部成功时统一生效,任一操作失败时都不修改数据树。

multi 常用于“检查旧版本后更新配置”“创建任务同时写入索引”“删除成员同时更新计数”等需要保持一致的操作。它不是跨系统事务,不能同时覆盖数据库、消息队列或另一个 ZooKeeper 集群。
使用版本检查组成事务
片段示例:假设 zk 已连接,/config/payment 当前版本为 3,并且 /audit 已存在。
java
import java.nio.charset.StandardCharsets;
import java.util.List;
import org.apache.zookeeper.CreateMode;
import org.apache.zookeeper.KeeperException;
import org.apache.zookeeper.Op;
import org.apache.zookeeper.OpResult;
import org.apache.zookeeper.ZooDefs;
String configPath = "/config/payment";
String auditPath = "/audit/config-" + System.currentTimeMillis();
List<Op> operations = List.of(
Op.check(configPath, 3),
Op.setData(
configPath,
"{\"timeoutMs\":5000}".getBytes(StandardCharsets.UTF_8),
3
),
Op.create(
auditPath,
"updated".getBytes(StandardCharsets.UTF_8),
ZooDefs.Ids.OPEN_ACL_UNSAFE,
CreateMode.PERSISTENT
)
);
try {
List<OpResult> results = zk.multi(operations);
System.out.println("committed=" + results.size());
} catch (KeeperException e) {
System.out.println("rolledBack=" + e.code());
}预期结果:版本仍为 3 时,三个操作一起提交。
text
committed=3若其他客户端已更新节点,版本检查失败,配置和审计节点都不会写入。
text
rolledBack=BADVERSION处理失败与重试
BADVERSION、NONODE、NODEEXISTS 通常表示业务前置条件不成立,应重新读取状态并重新决策,不要原样无限重试。同步调用失败时应结合异常码和异常路径定位前置条件;只有成功返回时,OpResult 的顺序才与输入操作一致。
遇到 CONNECTIONLOSS 时,客户端无法仅凭异常判断事务是否已经提交。应重新读取目标节点、版本或业务标识确认结果;包含顺序节点或非幂等创建时,更不能直接重复提交。
单个 multi 也应保持小而明确。大量数据会增加请求体、事务日志和服务端处理时间,不要把它当作批量导入接口。
本课总结
multi保证同一请求内的操作全部成功或全部失败Op.check可把版本条件与写操作放进同一原子事务- 连接丢失后的提交状态可能不确定,重试前必须先核验
下一课预告
下一课将从单次操作转向整体数据模型,设计更清晰的节点路径、数据格式与数量边界。
按自己的节奏,确认真正理解。