Emscripten编译的WASM文件桌面端正常移动端浏览器解析失败如何解决

Unhandled Promise Rejection: Error: abort(Error: WebAssembly.Module doesn't parse at byte xxx

该报错核心原因是编译生成的WASM文件使用了当前移动端浏览器不支持的WebAssembly扩展特性，Emscripten 3.0.1默认开启的多项新特性未匹配老旧移动端浏览器的兼容范围，同时OpenCV 4.5.3的默认WASM编译选项也会开启部分高版本特性。

• 禁用WASM SIMD扩展（90%以上该类报错的诱因）
  编译OpenCV时在cmake参数中添加：
  cmake ... -DWITH_WASM_SIMD=OFF -DCMAKE_C_FLAGS="-msimd128=0" -DCMAKE_CXX_FLAGS="-msimd128=0"
  最终链接生成WASM时，emcc参数额外添加 -msimd128=0
• 禁用未适配的多线程特性
  若业务不需要多线程能力，编译时添加参数：
  cmake ... -DWITH_PTHREADS_PF=OFF
  emcc链接参数添加 -pthread=0
  若必须使用多线程，需要给静态资源服务配置两个响应头：

  Cross-Origin-Opener-Policy: same-origin
  Cross-Origin-Embedder-Policy: require-corp
  

• 关闭其他高版本WASM特性
  编译参数额外添加以下配置，兼容老旧移动端浏览器：
  emcc ... -s WASM=1 -s BULK_MEMORY=0 -s STANDALONE_WASM=0

编译完成后可直接在Chrome开发者工具的设备仿真模式中选择iOS 15、安卓Chrome 88及以下版本的设备进行测试，确认无解析报错后再上线。

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