服务注册与分布式协调 / 系统课时
配置监听与版本发布
配置监听与版本发布
本课实现可回滚的配置发布链路。发布端先写入不可变版本,再以节点版本为条件更新 current;消费端校验新版本后原子替换本地缓存,失败时继续使用旧配置。
学习目标
- 实现不可变版本与
current指针的发布模型 - 使用版本条件避免并发发布互相覆盖
- 在校验失败、断线和回滚时保持可用配置
设计发布流程
配置内容写入 /configs/<APP>/versions/<VERSION>,创建后不再修改;/configs/<APP>/current 只保存当前版本号。这样可以先完整校验候选版本,再切换一个很小的指针节点。

使用版本条件发布
下面是片段示例,依赖共享 CuratorFramework。它假设候选版本节点已创建并通过内容校验,current 节点内容为 UTF-8 版本号。
import java.nio.charset.StandardCharsets;
import org.apache.curator.framework.CuratorFramework;
import org.apache.zookeeper.data.Stat;
static void switchCurrent(
CuratorFramework client,
String app,
String newVersion) throws Exception {
String currentPath = "/configs/" + app + "/current";
Stat stat = new Stat();
client.getData().storingStatIn(stat).forPath(currentPath);
client.setData()
.withVersion(stat.getVersion())
.forPath(
currentPath,
newVersion.getBytes(StandardCharsets.UTF_8));
}预期行为
current 未被其他发布者修改时,指针切换到 <NEW_VERSION>
并发发布已先修改 current 时,当前调用收到 BadVersion
版本节点内容保持不变,消费者只通过 current 决定生效版本只依赖 setData 的版本条件即可阻止静默覆盖。若发布还包含审计节点等多项变更,可使用 multi 事务把检查与变更组合为原子操作。
消费端监听与本地切换
消费端监听 current,而不是监听所有 versions。收到变化后读取版本号,再加载对应版本内容,依次验证节点存在、schemaVersion、字段约束和 checksum。
校验成功后构造新的不可变配置对象,并用一次原子引用替换本地缓存。业务线程始终读取完整旧对象或完整新对象,不能在原对象上逐字段修改。
监听回调只负责触发刷新。若短时间连续发布多个版本,可合并刷新任务并最终读取 current 的最新值,不要求逐个处理所有中间事件。
校验失败与断线策略
新版本不存在、JSON 无法解析、checksum 不一致或业务约束失败时,不更新本地缓存,并记录应用名、目标版本、失败阶段和 current 的节点版本。旧配置继续服务,健康检查可标记为降级而不是直接清空配置。
ZooKeeper 暂时断线时继续使用最后一次成功配置;连接恢复后重新读取 current 做一次全量对账。只有明确业务要求强一致停机时,才在配置过旧超过阈值后拒绝服务。
回滚与历史清理
回滚不是修改旧版本内容,而是把 current 条件更新回已验证的历史版本。回滚同样使用 Stat.version,避免覆盖新的正常发布。
历史版本按保留数量或时间清理,但必须排除 current 指向的版本和仍在灰度使用的版本。删除前生成清单并确认消费者最低版本,不能在发布链路中同步递归删除大量节点。
验收测试
连续发布合法版本 v000002 和非法版本 v000003。两个应用实例应先切换到 v000002;收到 v000003 后均保留 v000002,并产生明确告警。
再把 current 回滚到 v000001,两个实例应完成一致切换。并发启动两个发布者时,只允许一个版本条件更新成功,另一个收到 BadVersion 并重新决策,不能静默覆盖。
本课总结
- 不可变版本加
current指针能把发布、审计和回滚解耦 - 发布端用节点版本做 CAS,消费端校验后原子替换本地缓存
- 新配置失败或连接中断时保留最后一次成功配置,并在恢复后对账
下一课预告
后续实践可在此基础上补充综合联调、压测和故障演练,验证四个模块在会话丢失与节点故障下仍能正确协作。