服务注册与分布式协调 / 系统课时
Curator 事务
Curator 事务
Curator 事务把多个 ZooKeeper 写操作一次性提交:只要其中任意检查或写入失败,整组操作都不会部分生效。本篇用 transactionOp() 组合检查、创建、更新和删除,并通过版本冲突验证原子回滚。
学习目标
- 使用
TransactionOp构造check、create、setData与delete - 用版本号把并发检查和数据修改放进同一个原子提交
- 根据提交结果和失败后的节点状态验证事务是否真正原子
事务 API 的本质
Curator 的现代事务 API 分两步:先用 client.transactionOp() 把每个动作构造成 CuratorOp,再交给 client.transaction().forOperations(...) 一次提交。底层对应 ZooKeeper 的 multi 操作,因此“构造操作”本身不会立刻修改节点。
check 很适合做乐观并发控制。把读取到的 ZNode 版本带入事务后,只有版本仍然匹配时,后续创建、更新、删除才会一起提交;如果版本已经变化,ZooKeeper 会拒绝整个事务,而不是只拒绝其中一条。

构建包含四类操作的事务
下面示例假设本机已有可连接的 ZooKeeper,连接串默认是 127.0.0.1:2181,也可以把实际连接串作为第一个命令行参数传入。示例先准备两个节点,再在一个事务中完成版本检查、审计节点创建、配置更新和旧节点删除。
import java.nio.charset.StandardCharsets;
import java.util.List;
import java.util.concurrent.TimeUnit;
import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.framework.api.transaction.CuratorOp;
import org.apache.curator.framework.api.transaction.CuratorTransactionResult;
import org.apache.curator.framework.api.transaction.TransactionOp;
import org.apache.curator.retry.ExponentialBackoffRetry;
import org.apache.zookeeper.KeeperException;
import org.apache.zookeeper.data.Stat;
public class CuratorTransactionDemo {
private static final String ROOT = "/tx-demo";
public static void main(String[] args) throws Exception {
String connectString = args.length > 0 ? args[0] : "127.0.0.1:2181";
try (CuratorFramework client = CuratorFrameworkFactory.newClient(
connectString, new ExponentialBackoffRetry(1000, 3))) {
client.start();
if (!client.blockUntilConnected(5, TimeUnit.SECONDS)) {
throw new IllegalStateException("ZooKeeper connection timeout");
}
if (client.checkExists().forPath(ROOT) != null) {
client.delete().deletingChildrenIfNeeded().forPath(ROOT);
}
client.create().forPath(ROOT);
client.create().forPath(ROOT + "/config", bytes("v1"));
client.create().forPath(ROOT + "/obsolete", bytes("old"));
Stat stat = client.checkExists().forPath(ROOT + "/config");
int expectedVersion = stat.getVersion();
TransactionOp op = client.transactionOp();
CuratorOp check = op.check()
.withVersion(expectedVersion)
.forPath(ROOT + "/config");
CuratorOp create = op.create()
.forPath(ROOT + "/audit", bytes("created"));
CuratorOp update = op.setData()
.withVersion(expectedVersion)
.forPath(ROOT + "/config", bytes("v2"));
CuratorOp delete = op.delete()
.withVersion(0)
.forPath(ROOT + "/obsolete");
List<CuratorTransactionResult> results =
client.transaction().forOperations(check, create, update, delete);
System.out.println("committed operations=" + results.size());
System.out.println("config=" + text(client.getData().forPath(ROOT + "/config")));
System.out.println("audit=" + (client.checkExists().forPath(ROOT + "/audit") != null));
System.out.println("obsolete=" + (client.checkExists().forPath(ROOT + "/obsolete") != null));
// 仍使用旧版本号,故意制造版本冲突;后面的 create 也必须回滚。
CuratorOp staleCheck = op.check()
.withVersion(expectedVersion)
.forPath(ROOT + "/config");
CuratorOp shouldRollback = op.create()
.forPath(ROOT + "/should-not-exist", bytes("x"));
try {
client.transaction().forOperations(staleCheck, shouldRollback);
} catch (KeeperException.BadVersionException e) {
System.out.println("failure=" + e.getClass().getSimpleName());
}
System.out.println("rollback node=" +
(client.checkExists().forPath(ROOT + "/should-not-exist") != null));
System.out.println("config after failure=" +
text(client.getData().forPath(ROOT + "/config")));
}
}
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);
}
}预期输出
committed operations=4
config=v2
audit=true
obsolete=false
failure=BadVersionException
rollback node=false
config after failure=v2如果使用的连接地址、会话建立时间或服务器日志不同,实际环境信息会变化,但以上业务输出应保持一致。
版本检查与失败边界
事务里的 withVersion(expectedVersion) 不是装饰信息,而是并发条件。读取 Stat.version 后,若另一个客户端先修改了该节点,原事务中的 check 或 setData 会触发 BadVersionException,后续操作不会留下半完成状态。
需要注意,事务只能保证同一个 ZooKeeper 集群内这组 ZNode 操作的原子性。它不能把数据库写入、HTTP 调用、消息发送等外部副作用一起纳入 ZooKeeper 事务;这类跨系统一致性仍要由业务协议补偿或重新设计。
当一组协调状态必须“一起成功或一起失败”,并且这些状态都位于 ZooKeeper 中时,Curator 事务能把版本校验与多节点修改合并成一个清晰的原子边界。