Rust / 系统课时

使用 Semaphore 限制并发

使用 Semaphore 限制并发

当多个异步任务会同时占用数据库连接、外部 API 或昂贵计算资源时,需要给并发量设置硬上限。本节用 Tokio 的 Semaphore 把“能否进入资源区”变成许可证管理,并说明 permit 何时释放以及公平排队带来的影响。

学习目标

  • 使用 Semaphore 和 OwnedSemaphorePermit 把并发量限制在固定上限内
  • 说明 permit 的获取、持有、释放与任务取消之间的关系
  • 理解公平等待队列以及 acquire_many 可能造成的队首阻塞

Semaphore 限制的是什么

Semaphore::new(n) 创建 n 个许可证。任务在进入受保护的资源区之前先申请 permit;有许可证时立即获得,没有时异步等待。它不像互斥锁那样强制一次只允许一个任务进入,而是允许最多 n 个任务同时占用资源。

因此,许可证数量应该对应真正稀缺的容量,例如连接池最多允许的并发请求数,而不是简单等于任务数量。permit 应只覆盖资源实际被占用的代码区间,过早获取会制造无谓等待,过晚获取则起不到限流作用。

可运行的并发限制示例

新建一个 Rust 项目,并在 Cargo.toml 中加入 Tokio。这里仅启用示例需要的运行时、宏、同步与计时功能。

toml
[package]
name = "semaphore-demo"
version = "0.1.0"
edition = "2021"

[dependencies]
tokio = { version = "1", features = ["macros", "rt", "sync", "time"] }

依赖配置本身没有控制台输出。将下面代码保存为 src/main.rs;5 个任务都会执行,但同一时刻最多只有 2 个任务持有 permit。

rust
use std::sync::{
    atomic::{AtomicUsize, Ordering},
    Arc,
};
use tokio::{
    sync::Semaphore,
    time::{sleep, Duration},
};

#[tokio::main(flavor = "current_thread")]
async fn main() {
    const LIMIT: usize = 2;

    let semaphore = Arc::new(Semaphore::new(LIMIT));
    let active = Arc::new(AtomicUsize::new(0));
    let peak = Arc::new(AtomicUsize::new(0));
    let mut handles = Vec::new();

    for _ in 0..5 {
        let limiter = semaphore.clone();
        let active = active.clone();
        let peak = peak.clone();

        handles.push(tokio::spawn(async move {
            // Owned permit 可以安全地随任务一起移动并跨 await 持有。
            let permit = limiter
                .acquire_owned()
                .await
                .expect("semaphore closed");

            let now = active.fetch_add(1, Ordering::SeqCst) + 1;
            peak.fetch_max(now, Ordering::SeqCst);

            // 这里代表真正占用受限资源的异步工作。
            sleep(Duration::from_millis(50)).await;

            active.fetch_sub(1, Ordering::SeqCst);
            drop(permit); // 释放 permit,等待队列中的下一个任务才能继续。
        }));
    }

    for handle in handles {
        handle.await.expect("task panicked");
    }

    println!("all tasks finished");
    println!("peak <= limit: {}", peak.load(Ordering::SeqCst) <= LIMIT);
    println!("available permits: {}", semaphore.available_permits());
}

预期输出

text
all tasks finished
peak <= limit: true
available permits: 2

available permits: 2 说明所有任务结束后许可证都已经归还;peak <= limit: true 则验证受保护区内同时活跃的任务数没有突破上限。执行 cargo run 即可复现。

permit 生命周期与公平排队

acquire_owned() 返回 OwnedSemaphorePermit。任务持有它期间,占用的许可证不会回到池中;permit 被 drop,或持有它的任务被取消并销毁时,许可证会随值的析构而自动归还。把 permit 保存在过大的作用域中,会让并发上限看起来“莫名变低”。

Semaphore 许可证生命周期与等待队列

Tokio 的异步获取采用公平等待队列:等待者按请求顺序获得许可证。需要特别注意,多许可证请求也参与同一公平规则;如果队首 acquire_many 需要的数量暂时凑不齐,它可能让后面只需要 1 个许可证的任务继续等待。取消尚未完成的获取操作会失去原来的排队位置。

使用边界

Semaphore 适合限制“同时进行多少件事”,而不是保护某个值只能被一个任务修改;后者通常应使用 Mutex 或其他同步原语。限流时还应避免在拿到 permit 后执行与稀缺资源无关的长时间工作,否则许可证会被无效占用。

如果系统要停机,可以关闭 semaphore,使等待中和后续的获取返回错误;业务代码应决定这是正常退出信号还是异常。真正稳定的并发治理取决于两件事:许可证数量对应真实资源容量,permit 的作用域精确覆盖资源占用区间。

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

目录与阅读设置

阅读设置

17

记录一个想法

使用 Semaphore 限制并发

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

登录哪都通