AssemblyScript函数在Node.js中触发RuntimeError: memory access out of bounds求助

核心原因 #

你直接传递JS原生字符串给Wasm导出的函数是错误的。AssemblyScript定义的string类型对应Wasm线性内存中的UTF-8编码字节序列指针，而非JS的原生字符串类型。浏览器中能正常运行是因为AssemblyScript的浏览器运行时自动完成了类型适配，但Node.js环境缺少完整的运行时导入，导致非法内存访问——Windows的memory access out of bounds、macOS的Bus error 10只是系统层面的错误提示差异，本质原因完全一致。

解决方案 #

推荐使用AssemblyScript官方提供的@assemblyscript/loader处理JS与Wasm之间的类型转换，它能自动完成内存管理和类型适配，同时完善导入对象的配置。

步骤1：安装依赖 #

npm install @assemblyscript/loader

步骤2：修改Node.js代码 #

const fs = require("fs");
const loader = require("@assemblyscript/loader");

loader.instantiate(fs.readFileSync("./build/F.wasm"), {
  env: {
    abort: (messagePtr, fileNamePtr, line, column) => {
      // 可选：完善错误输出，便于调试
      const message = loader.UTF8ToString(messagePtr, exports.memory);
      console.error(`Abort: ${message} at ${line}:${column}`);
    }
  }
}).then(({ exports }) => {
  // 将JS字符串转换为Wasm内存中的UTF-8序列，返回内存指针
  const strPtr = loader.stringToUTF8("4719512002889", exports.memory);
  // 调用Wasm函数，传入指针
  console.log(exports.F(strPtr)); // 输出：13
  // 释放内存，避免内存泄漏
  loader.freeUTF8(strPtr, exports.memory);
});

手动处理方案（不使用loader） #

如果不想依赖loader，可手动完成字符串编码与内存写入：

const fs = require("fs");
const buffer = fs.readFileSync("./build/F.wasm");

WebAssembly.instantiate(buffer, {
  env: {
    abort: () => {},
    // 若编译时指定了--importMemory，需提供内存实例
    memory: new WebAssembly.Memory({ initial: 1 })
  }
}).then(({ instance: { exports } }) => {
  const targetStr = "4719512002889";
  const encoder = new TextEncoder();
  const utf8Bytes = encoder.encode(targetStr);
  
  // 获取Wasm内存的可写视图
  const memView = new Uint8Array(exports.memory.buffer);
  // 将UTF-8字节写入内存（示例使用偏移0，实际需确保该区域未被占用）
  memView.set(utf8Bytes, 0);
  
  // 传入内存指针调用函数
  console.log(exports.F(0)); // 输出：13
});

关于导入对象的说明 #

AssemblyScript编译的Wasm除了abort，还依赖内存管理、字符串处理等运行时函数。使用官方loader会自动补全大部分必要的导入配置，避免因导入缺失导致的各类错误。

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