服务注册与分布式协调 / 系统课时
共享计数器
共享计数器
共享计数器解决的是“多个进程同时读写同一个整数,如何避免更新互相覆盖”的问题。本节用 Curator SharedCount 演示基于 ZooKeeper 版本号的比较并交换,并加入变更监听,让计数更新既安全又可观察。
学习目标
- 理解普通“读取、加一、写回”为什么会在并发下丢失更新。
- 使用
VersionedValue与trySetCount完成跨进程安全递增。 - 正确处理
SharedCountListener的数值变化与连接状态事件。
共享计数为什么不能直接读后写
假设两个进程几乎同时读到计数值 10,它们都计算出 11 再写回 ZooKeeper,最终结果仍是 11,而不是 12。问题不在“加一”本身,而在读取和写入之间缺少并发条件检查。
ZooKeeper 的数据节点带有版本号。SharedCount.getVersionedValue() 同时取得计数值和版本,trySetCount(previous, newValue) 只会在版本仍与 previous 一致时写入;若其他进程已经抢先修改,调用返回 false,当前进程重新读取再计算即可。Curator 当前 API 也明确建议使用带 VersionedValue 的重载获得更强的原子性保证。 :contentReference[oaicite:0]{index=0}

用 SharedCount 做原子递增
下面示例假设 ZooKeeper 可通过 127.0.0.1:2181 访问,项目已引入 Curator Framework 与 Recipes。/demo/shared-count 第一次创建时以 0 为初始值;后续启动会读取节点中已经存在的计数,而不会重新覆盖为 0。SharedCount 使用前必须 start(),结束时应关闭。 :contentReference[oaicite:1]{index=1}
import java.util.concurrent.CountDownLatch;
import java.util.concurrent.TimeUnit;
import org.apache.curator.framework.CuratorFramework;
import org.apache.curator.framework.CuratorFrameworkFactory;
import org.apache.curator.framework.recipes.shared.SharedCount;
import org.apache.curator.framework.recipes.shared.SharedCountListener;
import org.apache.curator.framework.recipes.shared.SharedCountReader;
import org.apache.curator.framework.recipes.shared.VersionedValue;
import org.apache.curator.framework.state.ConnectionState;
import org.apache.curator.retry.ExponentialBackoffRetry;
public class SharedCountDemo {
private static final String PATH = "/demo/shared-count";
public static void main(String[] args) throws Exception {
String connect = args.length > 0 ? args[0] : "127.0.0.1:2181";
CountDownLatch changed = new CountDownLatch(1);
try (CuratorFramework client = CuratorFrameworkFactory.newClient(
connect, new ExponentialBackoffRetry(1000, 3));
SharedCount count = new SharedCount(client, PATH, 0)) {
client.start();
if (!client.blockUntilConnected(5, TimeUnit.SECONDS)) {
throw new IllegalStateException("ZooKeeper 连接超时");
}
count.start();
count.addListener(new SharedCountListener() {
@Override
public void countHasChanged(SharedCountReader reader, int newCount) {
System.out.println("监听到计数变化: " + newCount);
changed.countDown();
}
@Override
public void stateChanged(CuratorFramework c, ConnectionState state) {
if (state == ConnectionState.SUSPENDED || state == ConnectionState.LOST) {
System.out.println("连接状态变化: " + state);
}
}
});
while (true) {
VersionedValue<Integer> current = count.getVersionedValue();
int next = current.getValue() + 1;
if (count.trySetCount(current, next)) {
System.out.printf("更新成功: %d -> %d%n", current.getValue(), next);
break;
}
System.out.println("发生版本冲突,重新读取后重试");
}
changed.await(3, TimeUnit.SECONDS);
}
}
}预期输出
更新成功: <VALUE> -> <VALUE>
监听到计数变化: <VALUE>同一路径被其他进程同时修改时,还可能先看到“发生版本冲突,重新读取后重试”。三个 <VALUE> 的实际数字由节点当前值决定,监听行与“更新成功”行的先后也可能因异步回调调度而变化。
监听值变化时要同时关注连接状态
SharedCountListener 不只接收计数变化,它还参与 Curator 的连接状态通知。连接进入 SUSPENDED 后,应用不能继续把本地缓存的计数视为可靠最新值;发生 LOST 时更不能据此执行需要强一致判断的业务动作。恢复后应重新确认当前值,再继续依赖计数结果。 :contentReference[oaicite:2]{index=2}
监听适合做进度展示、阈值触发或本地缓存刷新,但不要把“监听到了每一次中间值”当成业务正确性的前提。真正决定一次递增是否成功的仍是带版本条件的写入结果,而不是监听回调。
什么时候适合使用 SharedCount
SharedCount 适合共享少量整数状态,例如当前活动任务数、阶段编号或简单配额计数。并发不高时,版本冲突后重试的实现直观且容易审计;如果竞争非常激烈,则应限制重试次数并增加退避,避免所有客户端持续抢写同一个 znode。
还要区分“当前计数”和“不可丢失的事件记录”。如果每一次增减都必须审计、追溯或按顺序消费,单个共享整数无法保存历史,应把事件写入持久化日志或消息系统,再由 ZooKeeper 只承担协调状态。