Rust库中async函数为何未生成poll函数？

现象回顾 #

• 在main.rs中定义async函数并通过#[tokio::main]调用时，执行readelf -sW查看符号表，能找到该Future对应的poll函数和上下文初始化函数符号
• 但在lib.rs中定义async函数，执行cargo rustc -- --emit=obj编译后，符号表中仅存在上下文初始化函数，找不到poll函数符号

为什么Lib中的Async函数没生成Poll符号？ #

这是Rust编译器的死代码消除（Dead Code Elimination, DCE）机制导致的。Async函数本质是语法糖，展开后会生成一个实现Future trait的匿名结构体，poll是该结构体的核心方法。如果lib中的async函数没有被任何代码实际调用或触发其poll方法（比如从未被await，也没有被作为Future类型传递给其他依赖poll的逻辑），编译器会判定poll方法为死代码，直接从编译产物中移除。

而main.rs中的async函数因为被#[tokio::main]处理后，Tokio运行时会主动调用其poll方法，所以编译器会保留该符号。

Poll函数何时会被生成？ #

只有当编译器能确定poll方法会被实际使用时，才会生成对应的符号。常见触发场景：

• 该async函数被直接await（无论是lib内部还是外部crate调用时）
• 函数返回的Future被传递给需要Future trait的API（如tokio::spawn、futures::join等）
• 显式依赖该Future的poll方法实现逻辑，或通过类型约束强制编译器保留

能否强制生成Poll函数？ #

可以通过以下几种方式实现：

1. 添加#[no_mangle]属性
   给async函数加上该属性，编译器会禁止函数名混淆，并保留其关联的poll方法符号（因为Future结构体的符号与函数绑定）。注意这会让函数名暴露在全局符号表，可能引发命名冲突。

   #[no_mangle]
   pub async fn hello_world() {
       println!("Hello, world!");
   }
   

2. 使用编译选项禁用死代码消除

   • 编译时添加-C link-dead-code选项，强制链接器保留死代码：

     cargo rustc -- --emit=obj -C link-dead-code
     

   • 或者使用-C opt-level=0（Debug模式默认配置），但这会关闭所有优化，导致编译产物体积增大，不适合Release环境。

3. 在Lib中添加触发Poll的逻辑
   在lib中写一个函数，确保async函数的Future被使用，比如返回该Future或内部await它：

   pub async fn hello_world() {
       println!("Hello, world!");
   }
   
   // 触发hello_world的poll方法生成
   pub fn get_hello_future() -> impl Future<Output = ()> {
       hello_world()
   }
   

   只要get_hello_future被外部调用或在lib内部使用，hello_world对应的poll符号就会被保留。

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