Rust / 系统课时
使用 watch 传播最新状态
使用 watch 传播最新状态
watch 用一个共享槽位传播“当前最新状态”,接收端关心的是版本是否变化,而不是每次更新都形成一条待消费事件。本文通过连续更新演示 changed、borrow 与 borrow_and_update 的差异,并建立配置热更新和运行状态通知的正确用法。
学习目标
- 使用
watch::channel发布并读取最新状态。 - 解释
changed的版本已见语义,以及borrow与borrow_and_update的区别。 - 识别适合
watch的状态同步场景和不适合的事件流场景。
watch 保存的是最新值
watch::channel(initial) 以一个初始值创建发送端和接收端。通道始终只保留最新状态;发送端连续写入多个新值时,尚未处理的接收端可以直接看到最后一个值,中间版本不会排队等待逐个消费。
每个 Receiver 还维护“当前版本是否已见”的状态。初始接收端把初始值视为已见;changed().await 在出现未见版本时返回,并把当时的版本标记为已见。若多个更新在接收端再次等待之前已经发生,它只需要被唤醒去处理最新状态。

连续更新只处理最新状态
下面先连续发送 loading 和 ready。接收端第一次调用 changed 时已经存在未见版本,因此立即返回;读取到的是最新的 ready,而不是两个状态各处理一次。
use tokio::sync::watch;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let (tx, mut rx) = watch::channel("starting");
println!("initial={}", *rx.borrow());
tx.send("loading")?;
tx.send("ready")?;
rx.changed().await?;
// 读取实际拿到的最新值,并把这个版本同步标记为已见。
println!("first_changed={}", *rx.borrow_and_update());
println!("has_changed={}", rx.has_changed()?);
tx.send("degraded")?;
rx.changed().await?;
println!("second_changed={}", *rx.borrow_and_update());
drop(tx);
// 最后一个版本已经处理完,发送端关闭后 changed 返回错误。
println!("closed={}", rx.changed().await.is_err());
Ok(())
}预期输出
initial=starting
first_changed=ready
has_changed=false
second_changed=degraded
closed=true这个结果说明 watch 不承诺让接收端看到 loading。它承诺的是:接收端被唤醒后能够取得当前最新值,并能判断是否出现过尚未处理的新版本。
changed、borrow 与 borrow_and_update
borrow() 只借用当前值,不会把这个版本标记为已见;borrow_and_update() 在借用当前值的同时更新接收端的已见版本。has_changed() 只做同步检查,同样不会标记版本;changed().await 则等待未见版本并标记它。
在“等待变化,然后处理当前值”的循环里,优先使用 changed().await 配合 borrow_and_update()。原因是 changed 返回后到真正读取之间可能又发生一次更新:此时 borrow_and_update 会把实际读到的最新版本也标为已见,避免下一轮把同一个值再次当作未见版本处理。
适合传播状态,不适合传递事件
配置快照、服务健康状态、当前领导者、限流参数等都天然属于“只关心最新值”的数据,watch 可以让多个任务低成本观察变化。接收端启动时还能先通过 borrow 读取初始状态,再进入变化循环。
如果每一次变化本身都必须被处理,例如审计事件、订单状态迁移记录或计费明细,就不要使用 watch,因为快速连续更新会合并成最新状态。此时应选择能够保留每条消息的队列或持久化事件流。watch 的判断标准很简单:丢掉中间版本后,业务语义是否仍然正确。