Rust / 系统课时

理解 Pin 与 Future 移动约束

理解 Pin 与 Future 移动约束

Pin 解决的是“某个值一旦开始依赖自身地址,就不能再被安全移动”的问题。异步 Future 可能在状态机内部形成对自身字段的引用,因此 Future::poll 接收的是 Pin<&mut Self>;理解这层约束后,就能判断 Tokio 日常代码何时完全不用碰 Pin,何时必须显式固定 Future。

学习目标

  • 解释自引用 Future 在移动后为什么可能失效
  • 区分 Pin 与 Unpin 的基本语义
  • 判断 Tokio 代码中需要显式 Pin 的典型场景

Future 为什么不能随便移动

编译器会把跨 .await 仍然存活的局部变量放进生成的 Future 状态机。某些状态下,一个字段可能间接引用同一个 Future 中的另一个字段;如果 Future 在这之后整体换了内存地址,原引用记录的地址就可能失效。

Future 移动与 Pin 固定地址对比

这也是 Future trait 的核心方法把接收者写成 self: Pin<&mut Self> 的原因:执行器在轮询 Future 时,可以修改它的内部状态,但对可能是 !Unpin 的 Future,安全代码不能把整个值从已固定的位置搬走。

Pin 和 Unpin 各自保证什么

Pin<P> 是一个指针包装器。对 Pin<Box<T>> 来说,可以移动外层 Box 句柄,但被分配在堆上的 T 必须继续满足固定地址约束;对 Pin<&mut T> 来说,则是在借用期间禁止通过安全接口把被固定的 T 移出原位置。

Unpin 是自动 trait,表示“这个类型即使被 Pin,也不需要额外的不可移动保证”。当 T: Unpin 时,可以从 Pin<&mut T> 安全取得普通 &mut T;当 T: !Unpin 时,必须继续遵守固定地址约束。编译器生成的 async Future 不应被假定为 Unpin,所以通用 Future API 会按可能不可移动来设计。

移动句柄不等于移动 Future

下面的标准库示例把匿名 async Future 放进 Pin<Box<_>>。move_handle 接收并返回整个 Pin 句柄,句柄变量发生了移动,但堆中 Future 的地址保持不变。

rust
use std::future::Future;
use std::pin::Pin;

fn move_handle<F: Future>(future: Pin<Box<F>>) -> Pin<Box<F>> {
    // 移动的是 Pin<Box<F>> 句柄,不是堆上的 F。
    future
}

fn main() {
    let future = Box::pin(async { 42 });
    let before = (&*future) as *const _ as *const ();

    // 句柄经过按值传递后,比较被固定 Future 的地址。
    let future = move_handle(future);
    let after = (&*future) as *const _ as *const ();

    println!("same address: {}", before == after);
}

预期输出:

text
same address: true

这个例子说明 Pin 并不是“变量名不能移动”,而是被 Pin 的目标值不能以破坏固定地址保证的方式移动。对 Pin<Box<F>>,移动指针句柄是安全的,因为它仍然指向同一块堆内存。

Tokio 里什么时候需要显式 Pin

大多数 Tokio 代码不需要手写 Pin。直接对 Future 使用 .await,或把 Future 交给 tokio::spawn,相关固定通常由编译器生成的状态机和执行器内部处理,调用者只需使用普通 async 语法。

显式 Pin 常出现在更底层或更灵活的场景:手动实现或调用 Future::poll、把不同 Future 统一存进 Pin<Box<dyn Future<...>>>、需要长期保存并反复以可变引用轮询同一个非 Unpin Future,或者自己实现异步组合器。Tokio 的 tokio::pin! 宏和 Box::pin 都可用于建立这种固定关系,前者通常固定到当前栈作用域,后者把值固定在堆上。

不要把 Pin 当成并发锁

Pin 只讨论内存位置与移动语义,不提供线程安全、互斥或生命周期延长。它不会自动让 Future 变成 Send、Sync 或 'static,也不会阻止多个任务并发访问共享数据。

判断是否需要显式 Pin 时,先问一个问题:你是否正在越过 .await 之外,直接保存、借用或手动轮询一个可能 !Unpin 的 Future?如果没有,通常让 .await 和 Tokio 运行时处理即可;如果有,就需要明确选择栈上固定还是 Pin<Box<_>>,并保持被固定值的地址稳定。

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

目录与阅读设置

阅读设置

17

记录一个想法

理解 Pin 与 Future 移动约束

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

登录哪都通