Rust / 系统课时

使用 watch 传播最新状态

使用 watch 传播最新状态

watch 用一个共享槽位传播“当前最新状态”,接收端关心的是版本是否变化,而不是每次更新都形成一条待消费事件。本文通过连续更新演示 changed、borrow 与 borrow_and_update 的差异,并建立配置热更新和运行状态通知的正确用法。

学习目标

  • 使用 watch::channel 发布并读取最新状态。
  • 解释 changed 的版本已见语义,以及 borrow 与 borrow_and_update 的区别。
  • 识别适合 watch 的状态同步场景和不适合的事件流场景。

watch 保存的是最新值

watch::channel(initial) 以一个初始值创建发送端和接收端。通道始终只保留最新状态;发送端连续写入多个新值时,尚未处理的接收端可以直接看到最后一个值,中间版本不会排队等待逐个消费。

每个 Receiver 还维护“当前版本是否已见”的状态。初始接收端把初始值视为已见;changed().await 在出现未见版本时返回,并把当时的版本标记为已见。若多个更新在接收端再次等待之前已经发生,它只需要被唤醒去处理最新状态。

watch 最新值与版本变化

连续更新只处理最新状态

下面先连续发送 loading 和 ready。接收端第一次调用 changed 时已经存在未见版本,因此立即返回;读取到的是最新的 ready,而不是两个状态各处理一次。

rust
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(())
}

预期输出

text
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 的判断标准很简单:丢掉中间版本后,业务语义是否仍然正确。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 watch 传播最新状态

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

登录哪都通