Rust如何封装带生命周期的结构体避免生命周期传染扩散

直接固定生命周期为'static（适配你的单元测试场景） #

单元测试场景下你 spawn 的异步任务基本都满足'static 约束（测试用 Future 一般都会持有所有权或者绑定'static 数据），可以直接把LocalExecutor的生命周期固定为'static，不需要结构体带生命周期参数：

#[cfg(all(test, not(target = "wasm32")))]
struct MockThing {
    // 直接固定executor的生命周期为'static，结构体无需额外声明生命周期
    executor: async_executor::LocalExecutor<'static>,
}

impl MockThing {
    fn new() -> Self {
        Self {
            // LocalExecutor::new()的默认生命周期可以直接匹配'static约束
            executor: async_executor::LocalExecutor::new(),
        }
    }

    // 举个运行任务的示例，只要传入的Future满足'static约束即可，单元测试场景基本都符合要求
    fn run<T>(&self, fut: impl std::future::Future<Output = T> + 'static) -> T {
        futures_lite::future::block_on(self.executor.run(fut))
    }
}

这个方案下MockThing没有生命周期参数，和另外两个真实实现的签名完全对齐，条件编译逻辑不需要做任何修改，也不会污染上层API。

通用场景：用trait擦除类型和生命周期 #

如果后续你需要支持非'static的任务，或者要对外暴露更通用的接口，可以抽取无生命周期的公共trait做类型擦除，上层完全不需要感知内部实现的生命周期差异：

// 公共接口，无任何泛型或生命周期参数，上层代码仅依赖这个trait
trait TaskRunner {
    fn run<T>(&self, fut: impl std::future::Future<Output = T> + 'static) -> T;
}

// Mock实现
#[cfg(all(test, not(target = "wasm32")))]
struct MockThing {
    executor: async_executor::LocalExecutor<'static>,
}

#[cfg(all(test, not(target = "wasm32")))]
impl TaskRunner for MockThing {
    fn run<T>(&self, fut: impl std::future::Future<Output = T> + 'static) -> T {
        futures_lite::future::block_on(self.executor.run(fut))
    }
}

// WebAssembly实现
#[cfg(target = "wasm32")]
struct WasmThing;

#[cfg(target = "wasm32")]
impl TaskRunner for WasmThing {
    fn run<T>(&self, fut: impl std::future::Future<Output = T> + 'static) -> T {
        // WebAssembly平台的真实执行逻辑
    }
}

// 其余场景实现
#[cfg(not(any(all(test, not(target = "wasm32")), target = "wasm32")))]
struct DefaultThing;

#[cfg(not(any(all(test, not(target = "wasm32")), target = "wasm32")))]
impl TaskRunner for DefaultThing {
    fn run<T>(&self, fut: impl std::future::Future<Output = T> + 'static) -> T {
        // 其他场景的真实执行逻辑
    }
}

// 调用方仅需通过这个方法获取执行器，完全感知不到不同实现的差异
fn get_runner() -> impl TaskRunner {
    #[cfg(all(test, not(target = "wasm32")))]
    return MockThing { executor: async_executor::LocalExecutor::new() };
    #[cfg(target = "wasm32")]
    return WasmThing;
    #[cfg(not(any(all(test, not(target = "wasm32")), target = "wasm32")))]
    return DefaultThing;
}

LocalExecutor生命周期参数的作用 #

LocalExecutor<'a>的'a不是表示执行器内部持有&'a类型的引用，而是作为任务生命周期的约束标记，用来保证所有 spawn 到执行器的Future的生命周期都不会超过执行器本身，避免执行器被销毁后，未执行完的任务引用已经释放的资源导致悬垂指针。
用PhantomData标记为不变生命周期的目的是：

• 禁止生命周期的自动拓宽/收窄，保证'a和执行器实例的生命周期严格绑定
• 避免用户误用，比如把绑定了短生命周期任务的执行器用到更长的生命周期场景中，引发内存安全问题

遏制生命周期传染的通用方法 #

• 固定生命周期为'static：如果你的使用场景下，所有满足该类型约束的输入都符合'static要求，直接固定生命周期参数为'static，不需要结构体对外暴露生命周期
• 类型擦除：通过无泛型、无生命周期的公共trait封装实现，上层只依赖trait对象或impl Trait，完全隐藏内部的生命周期细节
• 私有封装：如果带生命周期的类型是结构体的私有成员，且对外暴露的所有方法签名都不涉及该生命周期参数，只要内部生命周期逻辑合法，编译器不会要求上层感知该生命周期

内容的提问来源于stack exchange，提问作者Xharlie