如何在Rust Wasmtime宿主程序中调用返回字符串的WASM函数？

WASM本身仅支持数值类型的参数和返回值，无法直接传递字符串。要实现字符串传递，需通过指针+长度的方式在WASM模块和宿主间交互，以下是完整实现示例：

一、WASM插件端代码（lib.rs） #

编译命令：cargo build --target=wasm32-unknown-unknown --release

use std::ffi::CString;
use std::os::raw::c_char;

static PLUGIN_NAME: &'static str = "Test Plugin";

// 返回C风格字符串的指针（静态字符串无需手动释放，动态分配需额外提供释放函数）
#[no_mangle]
pub extern "C" fn plugin_name() -> *mut c_char {
    let s = CString::new(PLUGIN_NAME).unwrap();
    s.into_raw()
}

// 返回字符串的有效字节长度（不含末尾空字符）
#[no_mangle]
pub extern "C" fn plugin_name_len() -> usize {
    PLUGIN_NAME.len()
}

二、Rust宿主端代码（main.rs） #

use wasmtime::{Engine, Linker, Module, Store, Memory};
use wasmtime_wasi::WasiCtxBuilder;

fn main() -> anyhow::Result<()> {
    let engine = Engine::default();

    let Some(file) = std::env::args().nth(1) else {
        anyhow::bail!("USAGE: host <WASM FILE>");
    };

    let module = Module::from_file(&engine, file)?;

    let linker = Linker::new(&engine);
    let wasi = WasiCtxBuilder::new()
        .inherit_stdio()
        .inherit_args()
        .expect("should always be able to inherit args")
        .build();
    let mut store = Store::new(&engine, wasi);

    let instance = linker.instantiate(&mut store, &module)?;

    // 获取WASM模块导出的内存实例（默认导出名为"memory"）
    let memory = instance.get_memory(&mut store, "memory")
        .ok_or_else(|| anyhow::anyhow!("WASM module does not export memory"))?;

    // 获取字符串长度
    let plugin_name_len = instance.get_typed_func::<(), usize>(&mut store, "plugin_name_len")?;
    let len = plugin_name_len.call(&mut store, ())?;
    println!("Length: {}", len);

    // 获取字符串指针
    let plugin_name = instance.get_typed_func::<(), usize>(&mut store, "plugin_name")?;
    let ptr = plugin_name.call(&mut store, ())?;

    // 从WASM内存读取字节并转换为Rust字符串
    let bytes = memory.data(&store)[ptr..ptr+len].to_vec();
    let name = String::from_utf8(bytes)?;
    println!("Plugin Name: {}", name);

    Ok(())
}

关键说明 #

1. 类型限制处理：WASM不支持直接返回&str，因此宿主需将WASM函数的返回值视为usize类型的指针，配合长度读取内存内容。
2. 内存读取：必须获取WASM模块导出的内存实例，才能访问指针指向的区域。Rust编译到WASM时默认会导出名为memory的内存。
3. 字符串安全：读取字节后需用String::from_utf8验证UTF-8编码，确保转换为合法的Rust字符串。
4. 内存管理：若插件返回动态分配的字符串（如用malloc创建），需在插件中额外提供释放函数，宿主调用后避免内存泄漏；本例使用静态字符串，无需释放。

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