Node.js中Worker线程postMessage()调用Stockfish引擎失败，命令行却正常的问题

问题描述 #

尝试用Node.js Worker线程运行Stockfish国际象棋引擎时遇到以下问题：

• 最初使用node-stockfish包，因AbortSignal类型定义版本过旧，npm安装失败
• 改用stockfish包安装成功，但官方文档极少
• 编写Worker线程代码发送命令后，收到worker.js received unknown command undefined错误；但命令行添加--experimental-wasm-threads和--experimental-wasm-simd标志直接运行stockfish.js时，命令可正常执行

测试代码：

import { Worker } from "worker_threads";

const engine = new Worker("./node_modules/stockfish/src/stockfish.js")
engine.on('message', (data) => console.log(data))
engine.postMessage('position startpos move e2e4 e7e5')
engine.postMessage('go movetime 3000')

输出结果：

worker.js received unknown command undefined
position startpos move e2e4 e7e5
worker.js received unknown command undefined
go movetime 3000

解决方案 #

1. 给Worker线程传递实验性标志 #

Worker线程是独立的执行环境，不会继承主进程的命令行标志，需要在创建Worker时显式传入execArgv参数：

import { Worker } from "worker_threads";

const engine = new Worker("./node_modules/stockfish/src/stockfish.js", {
  execArgv: ['--experimental-wasm-threads', '--experimental-wasm-simd']
})
engine.on('message', (data) => console.log(data))
engine.postMessage('position startpos move e2e4 e7e5')
engine.postMessage('go movetime 3000')

2. 检查Stockfish Worker的消息格式要求 #

部分Stockfish的JS封装并非直接接收字符串命令，而是期望特定结构的消息对象（比如包含command字段）。可以查看stockfish.js源码中的消息监听逻辑，若源码中通过message.command解析命令，需调整发送格式：

engine.postMessage({ command: 'position startpos move e2e4 e7e5' })
engine.postMessage({ command: 'go movetime 3000' })

3. 确保Worker文件路径正确 #

避免相对路径因主文件执行位置导致的错误，使用path模块解析绝对路径：

import { Worker } from "worker_threads";
import path from 'path';

const stockfishPath = path.resolve(__dirname, './node_modules/stockfish/src/stockfish.js');
const engine = new Worker(stockfishPath, {
  execArgv: ['--experimental-wasm-threads', '--experimental-wasm-simd']
})

engine.on('message', (data) => console.log(data))
engine.postMessage({ command: 'position startpos move e2e4 e7e5' })
engine.postMessage({ command: 'go movetime 3000' })

验证步骤 #

1. 先添加execArgv传递实验性标志，确认Wasm线程和SIMD功能正常启用
2. 若仍报错，检查stockfish.js的消息处理逻辑，调整发送的消息结构
3. 用绝对路径确保Worker文件被正确加载

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