Rust / 系统课时

保证取消安全

保证取消安全

tokio::select! 选中一个分支后,会丢弃同一轮其余未完成的 Future,也就是取消这些异步操作。本课聚焦真正的风险:操作已推进部分状态,但关键进度只保存在即将被丢弃的 Future 内部。

学习目标

  • 理解 Future 被丢弃时的取消语义
  • 识别 read_exact 在 select! 循环中的进度丢失风险
  • 把可恢复进度保存到 Future 之外,构造可安全重试的读取循环

取消安全看的是状态是否丢失

一个异步操作可以被安全取消,核心条件是:它在返回 Pending 后即使被丢弃,下一次重新创建 Future 也不会遗失已经完成但尚未对调用者可见的工作。

例如 AsyncReadExt::read 一次完成后会把本次读取字节数返回给调用者,因此可以把累计偏移保存在循环外。相反,read_exact 为了填满整个缓冲区,内部可能已经多次读取并维护“还差多少字节”的进度;如果此时另一个 select! 分支获胜,Future 被丢弃,这个内部偏移也随之消失。

read_exact 取消风险与外置进度

判断取消安全时要问两个问题:取消点之前是否可能已经消费数据、发送数据或改变队列位置;如果改变了,这个进度是否保存在 Future 之外并能在下一轮继续。只看函数名是否“可重试”并不够。

用外部偏移保存读取进度

下面用内存双工流模拟一个 4 字节帧。写端先发送 AB,80 毫秒后再发送 CD;读端在读到前两个字节后允许一次 30 毫秒超时参与竞争。超时会赢得这一轮 select!,但已经读取的字节数保存在 filled 中,因此下一轮不会从缓冲区开头重新开始。

项目依赖:

toml
[package]
name = "cancel-safe-read"
version = "0.1.0"
edition = "2024"

[dependencies]
tokio = { version = "1", features = ["full"] }

保存以下代码为 src/main.rs:

rust
use std::io::{Error, ErrorKind};
use tokio::{
    io::{AsyncReadExt, AsyncWriteExt},
    time::{sleep, Duration},
};

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let (mut reader, mut writer) = tokio::io::duplex(16);

    tokio::spawn(async move {
        writer.write_all(b"AB").await.unwrap();
        sleep(Duration::from_millis(80)).await;
        writer.write_all(b"CD").await.unwrap();
    });

    let mut frame = [0_u8; 4];
    let mut filled = 0_usize;
    let mut interrupted = false;

    while filled < frame.len() {
        tokio::select! {
            result = reader.read(&mut frame[filled..]) => {
                let n = result?;
                if n == 0 {
                    return Err(Error::new(
                        ErrorKind::UnexpectedEof,
                        "stream closed before the frame was complete",
                    ));
                }

                // 只有 read 成功返回后才推进外部状态,下一轮可从该偏移继续。
                filled += n;
                println!("read {n} bytes, filled = {filled}");
            }
            _ = sleep(Duration::from_millis(30)), if filled > 0 && !interrupted => {
                // 只制造一次取消点;关键进度 filled 留在 Future 外部。
                interrupted = true;
                println!("timeout, keep filled = {filled}");
            }
        }
    }

    println!("frame = {}", String::from_utf8_lossy(&frame));
    Ok(())
}

运行 cargo run。

预期输出:

text
read 2 bytes, filled = 2
timeout, keep filled = 2
read 2 bytes, filled = 4
frame = ABCD

这个写法的关键不是“换成 read 就自动安全”,而是每次成功读取后立即把 filled 更新到循环外。若超时分支获胜,本轮 read Future 被丢弃;下一轮仍从 frame[filled..] 开始,已确认的数据和偏移都还在。

哪些操作需要格外检查

在 Tokio 常见 API 中,mpsc::Receiver::recv、TcpListener::accept、AsyncReadExt::read 和 read_buf 适合放进 select! 循环反复竞争;read_exact、read_to_end、write_all 则可能在 Future 内维护部分进度,不能假设取消后重新调用等价于继续原操作。

操作 放入循环式 select! 的关注点
read / read_buf 成功结果返回后再推进外部偏移,可恢复
read_exact 内部可能已有部分读取进度,取消后重建会丢失该进度
write_all 可能已写出部分字节,重试整段会造成重复写入
recv / accept Tokio 将这些等待列为常见取消安全操作

取消安全最终是一种状态设计:凡是必须跨取消点保留的进度,都应放在比单次 Future 生命周期更长的位置。这样 select! 才能真正用于超时、关闭信号和多事件竞争,而不会在“正常取消”中悄悄破坏数据边界。

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

目录与阅读设置

阅读设置

17

记录一个想法

保证取消安全

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

登录哪都通