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

多操作事务

多操作事务

本课解决多个节点操作之间可能只成功一部分的问题。你将使用 multi 把版本检查、数据更新和审计节点创建提交为一个原子事务,并学会区分业务冲突、连接异常与整体回滚。

学习目标

  • 理解 multi 的原子性与顺序执行语义
  • 使用版本检查保护并发更新
  • 正确处理失败结果与不确定提交状态

为什么需要多操作事务

单独调用 setData、create 和 delete 时,每次调用都是独立事务。若第二步失败,第一步已经生效,应用必须自行补偿。multi 将多个操作作为一个请求提交:全部成功时统一生效,任一操作失败时都不修改数据树。

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 可把版本条件与写操作放进同一原子事务
  • 连接丢失后的提交状态可能不确定,重试前必须先核验

下一课预告

下一课将从单次操作转向整体数据模型,设计更清晰的节点路径、数据格式与数量边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

多操作事务

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

登录哪都通