Emscripten编译WASM在Web Worker运行报错：module不是对象或函数

这个错误我之前也碰到过，本质是Emscripten编译的Wasm模块不能脱离它的专属运行时环境单独实例化，你直接把Wasm二进制模块传给Worker，却没提供它依赖的导入对象集合，自然会报错找不到global这类核心模块。

错误原因拆解 #

Emscripten编译的Wasm不是孤立的二进制文件，它依赖一套Emscripten自己实现的运行时导入（比如global全局对象、env模块里的内存管理/控制台输出等函数）。你只传递了Wasm模块到Worker，但Worker环境里没有这些预定义的导入对象，实例化时就会触发依赖缺失的错误。

两种靠谱的解决方法 #

方法一：直接用Emscripten生成的JS运行时脚本（最省心）

Emscripten默认编译时会生成对应的.js文件，这个文件已经封装了所有Wasm实例化需要的导入逻辑，直接在Worker里加载它就行：

1. 确保编译时生成了JS文件（默认编译命令就会生成，比如emcc my_code.c -o my_module.js）
2. 修改Worker脚本：

// worker.js
// 加载Emscripten生成的运行时脚本，它会自动处理Wasm的加载和依赖
importScripts('my_module.js');

// 等待运行时初始化完成后再操作
Module.onRuntimeInitialized = function() {
  console.log("Wasm运行时在Worker中准备就绪");
};

// 接收主进程消息，调用Wasm导出的函数
self.onmessage = function(evt) {
  if (evt.data.type === "callFunc") {
    const result = Module._my_exported_function(evt.data.param);
    self.postMessage({ result });
  }
};

3. 主进程代码简化为创建Worker并发送指令：

// 主进程代码
const g_worker = new Worker('worker.js');

// 触发Worker中的Wasm函数调用
g_worker.postMessage({ type: "callFunc", param: 42 });
g_worker.onmessage = function(evt) {
  console.log("Worker返回结果：", evt.data.result);
};

方法二：用MODULARIZE模式手动控制初始化（适合需要自定义配置的场景）

如果需要更灵活地控制Wasm模块的初始化时机或自定义运行时行为，可以在编译时开启MODULARIZE参数：

1. 编译时添加参数，生成可复用的模块创建函数：

emcc my_code.c -o my_module.js -s MODULARIZE=1 -s EXPORT_NAME="createMyModule" -s EXPORTED_FUNCTIONS=['_my_exported_function']

2. 主进程导入函数并传递给Worker：

// 主进程代码
const g_worker = new Worker('worker.js');

// 导入Emscripten生成的模块创建函数
import('./my_module.js').then(({ createMyModule }) => {
  g_worker.postMessage(createMyModule);
});

g_worker.onmessage = function(evt) {
  console.log("Worker返回结果：", evt.data.result);
};

3. Worker中接收函数并初始化模块：

// worker.js
self.onmessage = async function(evt) {
  const createMyModule = evt.data;
  
  // 初始化模块，Emscripten会自动处理所有依赖导入
  const myModule = await createMyModule({
    // 可选：自定义运行时行为，比如重定向控制台输出
    print: function(text) {
      console.log("Worker中Wasm输出：", text);
    }
  });

  // 调用导出的函数并返回结果
  const result = myModule._my_exported_function(42);
  self.postMessage({ result });
};

避坑提醒 #

千万别尝试手动构建Emscripten需要的所有导入对象——这涉及大量底层运行时细节（内存管理、系统调用模拟等），维护成本极高，用官方提供的JS运行时或MODULARIZE模式才是最可靠的方案。

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