从Python加载Rust生成的Wasm二进制文件时函数签名不匹配问题

问题背景 #

我用wasm_bindgen在Rust里导出了get_fact函数，通过wasm-pack --target nodejs构建Wasm文件后，在Node.js里能正常调用，但用Python的wasmer库调用时，报错RuntimeError: Parameters of type [] did not match signature [I32] -> []，为什么两者对函数签名的认知不一样？

相关代码 #

Rust 代码

#[wasm_bindgen]
pub fn get_fact() -> String {
    "Chuck Norris can slam a revolving door".to_string()
}

Node.js 测试代码

const assert = require('node:assert/strict');
const ck = require('../pkg/chuck_norris.js');

const actual = ck.get_fact();
assert.ok(actual.includes("Chuck Norris"));

Python 测试代码

from wasmer import engine, Store, Module, Instance
from wasmer_compiler_cranelift import Compiler
from pathlib import Path

rust_wasm = Path / "to" / "chucknorris_bg.wasm"

store = Store(engine.Universal(Compiler))
module = Module(store, rust_wasm.read_bytes())
instance = Instance(module)
get_fact = instance.exports.get_fact
actual = get_fact()
assert "Chuck Norris" in actual

原因解析 #

核心差异在于wasm_bindgen的适配机制：

• Node.js端：wasm-pack --target nodejs会生成配套的JavaScript胶水代码（比如chuck_norris.js），这个胶水代码会自动处理wasm_bindgen定义的ABI规则，包括字符串的内存分配、参数/返回值的转换。你调用的ck.get_fact()其实是胶水封装后的函数，而非直接调用Wasm模块里的原始导出函数。
• Python直接调用Wasm：wasmer库是直接加载Wasm字节码并调用模块导出的原始函数。而wasm_bindgen为了处理String这类Wasm原生不支持的复杂类型，会把返回String的Rust函数转换为接收一个i32参数、无返回值的Wasm函数——这个i32参数用来让调用者传入预分配的内存地址，供Wasm写入返回的字符串数据，所以直接调用时会要求传入i32类型参数，导致签名不匹配。

解决办法 #

方案1：改用原生Wasm兼容的导出方式 #

去掉#[wasm_bindgen]宏，改用#[no_mangle]导出函数，并手动处理字符串的内存传递（返回指针和长度）：

#[no_mangle]
pub extern "C" fn get_fact() -> *const u8 {
    // 末尾加\0方便C风格字符串读取，也可以只返回指针和长度
    "Chuck Norris can slam a revolving door\0".as_ptr()
}

#[no_mangle]
pub extern "C" fn get_fact_length() -> usize {
    "Chuck Norris can slam a revolving door".len()
}

Python端通过内存指针读取内容：

from wasmer import engine, Store, Module, Instance
from wasmer_compiler_cranelift import Compiler
from pathlib import Path

rust_wasm = Path / "to" / "chucknorris_bg.wasm"

store = Store(engine.Universal(Compiler))
module = Module(store, rust_wasm.read_bytes())
instance = Instance(module)

ptr = instance.exports.get_fact()
length = instance.exports.get_fact_length()
# 从Wasm内存中读取指定长度的字节并解码
actual = instance.memory.view(ptr, length).tobytes().decode()
assert "Chuck Norris" in actual

方案2：使用支持wasm_bindgen的Python工具 #

如果想保留wasm_bindgen的便捷性，可以选择支持其ABI的Python库，比如：

• 使用pyodide（适合浏览器/桌面Python环境，天然支持wasm_bindgen）
• 借助wasmer的wasm-bindgen兼容层（需要额外安装相关依赖并配置编译选项）

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