Rust+SDL2引擎经Emscripten编译WASM时线程启动失败求助

一、线程启动Panic（Resource temporarily unavailable） #

这个错误的核心是Emscripten pthread支持需要完整的编译+运行时配置，仅加-pthread不够：

1. 补全编译参数
   修改编译命令，添加pthread核心配置：

   EMCC_CFLAGS="-s ERROR_ON_UNDEFINED_SYMBOLS=0 --no-entry -s USE_PTHREADS=1 -s PTHREAD_POOL_SIZE=4 -s PROXY_TO_PTHREAD" cargo build -j 4 --verbose --target wasm32-unknown-emscripten --release
   

   参数说明：

   • -s USE_PTHREADS=1：启用pthread支持
   • -s PTHREAD_POOL_SIZE=4：预创建线程池，避免动态创建资源不足
   • -s PROXY_TO_PTHREAD：将Wasm主线程代理到pthread（浏览器UI线程无法阻塞，必须用这个参数规避）

2. 运行时环境要求

   • 浏览器端：必须在HTTPS/localhost环境运行，同时页面需添加响应头：Cross-Origin-Embedder-Policy: require-corp和Cross-Origin-Opener-Policy: same-origin，否则浏览器会禁用pthread依赖的SharedArrayBuffer
   • Node.js端：启动时需加参数：node --experimental-wasm-threads --experimental-wasm-bulk-memory your_script.js

3. 代码容错调整
   不要直接unwrap()线程创建结果，先做兼容性判断：

   use std::env;
   
   fn is_thread_supported() -> bool {
       env::var("EM_PTHREADS_ENABLED").map_or(false, |val| val == "1")
   }
   
   // 修改线程启动逻辑
   let physics_thread = if is_thread_supported() {
       thread::Builder::new().name("physics".to_string())
           .spawn(|| physics::start(rptx, sprx))
           .expect("Failed to spawn physics thread")
   } else {
       // 单线程降级逻辑
       std::thread::spawn(|| {
           physics::start(rptx, sprx);
       })
   };
   

二、SDL_ttf/SDL_mixer编译失败 #

1. 安装Emscripten SDL扩展
   先通过emsdk安装对应库：

   emsdk install sdl2 sdl2_ttf sdl2_mixer
   emsdk activate sdl2 sdl2_ttf sdl2_mixer
   

   编译前务必执行source ./emsdk_env.sh（Linux/macOS）或emsdk_env.bat（Windows）加载环境

2. Cargo依赖配置
   修改Cargo.toml，指定emscripten特性：

   [dependencies.sdl2]
   version = "0.35"
   features = ["ttf", "mixer", "emscripten"]
   
   [dependencies.sdl2_ttf]
   version = "0.35"
   features = ["emscripten"]
   
   [dependencies.sdl2_mixer]
   version = "0.35"
   features = ["emscripten"]
   

3. 编译参数添加SDL支持
   EMCC_CFLAGS中加入：-s USE_SDL=2 -s USE_SDL_TTF=2 -s USE_SDL_MIXER=2，告诉Emscripten链接对应库

三、rustflags无法配置-oformat=html #

-oformat=html是Emscripten的链接参数，不属于Rust的rustflags，两种解决方式：

1. 单独用emcc生成HTML
   先编译出Wasm文件，再手动链接生成HTML（保留自定义index.html）：

   # 第一步：编译Wasm
   EMCC_CFLAGS="-s ERROR_ON_UNDEFINED_SYMBOLS=0 -s USE_PTHREADS=1 -s USE_SDL=2 -s USE_SDL_TTF=2 -s USE_SDL_MIXER=2" cargo build --target wasm32-unknown-emscripten --release
   # 第二步：生成HTML
   emcc target/wasm32-unknown-emscripten/release/catgirl_engine.wasm -o index.html -s USE_PTHREADS=1 -s USE_SDL=2 -s USE_SDL_TTF=2 -s USE_SDL_MIXER=2 --no-entry
   

2. 在Cargo配置中通过link-arg传递
   修改config.toml，将参数放在linker参数里：

   [target.wasm32-unknown-emscripten]
   ar = "/path/to/emscripten/ar"
   linker = "/path/to/emscripten/emcc"
   rustflags = [
       "-C", "link-arg=-s USE_PTHREADS=1",
       "-C", "link-arg=-s USE_SDL=2",
       "-C", "link-arg=-oformat=html",
       # 其他必要参数
   ]
   

   注意：这种方式会让Cargo直接生成HTML，可能覆盖自定义index.html，建议优先用第一种方法

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