WebAssembly.instantiateStreaming忽略importObject的js.mem配置如何解决

问题原因 #

你当前遇到的自定义内存不生效是Emscripten编译默认配置导致的：默认编译出的WASM模块会在内部自行定义内存，没有声明从外部导入内存，所以你传入的所有内存配置都会被直接忽略。同时Emscripten默认初始内存为256页（16777216字节），刚好匹配你观测到的内存大小。

解决步骤 #

1. 调整Emscripten编译参数
   添加-s IMPORTED_MEMORY=1参数，强制让编译出的WASM模块从外部导入内存而非自行创建；如果需要限制最大内存，同步添加-s MAXIMUM_MEMORY=65536和你设置的1页最大内存匹配。修改后的编译指令为：

emcc -O3 main.c -o main.wasm --no-entry -s IMPORTED_MEMORY=1 -s MAXIMUM_MEMORY=65536

2. 调整JS端实例化参数
   Emscripten生成的WASM默认从env命名空间导入内存，键名为memory，修改你的实例化代码如下即可：

const memory = new WebAssembly.Memory({ initial: 1, maximum: 1 });

const { instance } = await WebAssembly.instantiateStreaming(
  fetch('main.wasm'),
  { env: { memory } },
);

console.log('did use same memory?', instance.exports.memory.buffer === memory.buffer);

调整后运行输出结果会变为true，代表实例已经成功使用你传入的自定义内存。

注意事项 #

• 开启IMPORTED_MEMORY后如果实例化时没有传入符合要求的内存，会直接抛出报错，可用来验证配置是否生效
• 传入的内存大小必须为65536字节（1个WASM页）的整数倍，且最大内存需和编译时指定的MAXIMUM_MEMORY一致，否则会实例化失败

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