WebAssembly跨JS与代理pthread共享数据的最优内存策略及Chrome92实现问题

1 Chrome 92 支持性说明 #

Chrome 92 已完整支持WebAssembly共享内存 + pthread特性，仅需满足页面跨域隔离要求：响应头配置Cross-Origin-Opener-Policy: same-origin和Cross-Origin-Embedder-Policy: require-corp即可正常使用SharedArrayBuffer相关能力。

2 最优内存策略 #

你当前选用的WebAssembly.Memory创建共享线性内存的思路是最优方案，核心要求是将该共享内存作为Emscripten模块的初始堆内存传入，保证JS、Wasm主线程、Wasm pthread三方共享同一块地址空间。

3 你当前问题的根因 #

你遇到的C++读取全为0的问题有两个核心错误：

• 你将JS侧的Float32Array实例直接传给了EMBIND绑定的C函数，C接收的指针本质是内存地址的字节偏移量（整数），无法识别JS的TypedArray对象
• 你单独创建的WebAssembly.Memory没有绑定到Emscripten模块的堆空间，C++侧默认读取的是自身独立的非共享堆，和你创建的共享内存完全隔离，自然读不到正确数据

另外你之前直接在Module.Heap32分配的内存无法共享，是因为没有给Emscripten指定共享内存作为初始堆，Emscripten默认创建的是非共享内存作为堆空间。

4 正确实现步骤 #

4.1 编译参数配置 #

编译Wasm模块时添加线程和共享内存相关参数：

emcc your_code.cpp -o output.js -pthread -s SHARED_MEMORY=1 -s EXPORTED_FUNCTIONS=['_malloc','_free'] --bind

4.2 初始化时传入共享内存 #

加载Emscripten模块前先创建共享内存，并配置为模块的初始内存：

// 创建共享内存
const sharedMemory = new WebAssembly.Memory({
  initial: 10,
  maximum: 100,
  shared: true
});
// 配置Emscripten模块参数
window.Module = {
  initialMemory: sharedMemory,
  // 其他你需要的模块配置项
};
// 再加载Emscripten生成的output.js胶水代码

4.3 JS侧分配可共享的堆内存 #

不要手动指定偏移量，用Emscripten导出的_malloc分配堆空间，返回值就是C++可直接使用的指针：

const FLOAT_BYTE_SIZE = 4;
const arrayLength = 2048; // 你需要的数组长度
// 分配内存，返回字节偏移量（即C++侧的float*指针）
const ptr = Module._malloc(arrayLength * FLOAT_BYTE_SIZE);
// 基于共享堆创建TypedArray写入数据
const sharedArray = new Float32Array(Module.HEAPF32.buffer, ptr, arrayLength);
sharedArray.set(yourDataArray); // 写入你要传递的数据

4.4 C++侧读取数据 #

EMBIND绑定的函数直接接收整数参数作为float*即可正常读取：

#include <emscripten/bind.h>

void process_data(float* data, int length) {
  // 这里直接读取data即可，该内存在所有pthread中都可共享访问
  for(int i=0; i<length; i++) {
    // 处理逻辑
  }
}

EMSCRIPTEN_BINDINGS(my_module) {
  emscripten::function("process_data", &process_data);
}

JS侧调用时直接传ptr和长度即可：

Module.process_data(ptr, arrayLength);

4.5 内存释放 #

用完后调用Module._free(ptr)释放堆内存，避免泄漏。

5 注意事项 #

• 多线程读写同一块共享内存时，需要添加同步机制：JS侧用Atomics相关API，C++侧用std::mutex、原子变量等，避免数据竞争
• WebAssembly共享内存的最大容量限制为2GB，配置maximum时不要超过该值

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