Node.js Worker Threads报错：process.send()非函数，退出码1

1. 明确process.send()的适用场景 #

process.send()是Worker线程专属的通信方法，主线程中不存在这个方法。如果你的SomeOtherfile.ts（主线程代码）里调用了它，直接触发报错。

• 检查代码：主线程与Worker通信必须用Worker实例的postMessage()方法，Worker线程则通过parentPort.postMessage()向主线程发送消息。
• 正确代码示例：
  主线程（SomeOtherfile.ts）：

  import { Worker } from 'worker_threads';
  const worker = new Worker('./test1.ts');
  // 主线程向Worker发送任务数据
  worker.postMessage({ imagePath: './target.jpg' });
  // 监听Worker返回的处理结果
  worker.on('message', (processedResult) => {
    console.log('图片处理完成:', processedResult);
  });
  

  Worker线程（test1.ts）：

  import { parentPort } from 'worker_threads';
  // 监听主线程的任务指令
  parentPort?.on('message', async (taskData) => {
    // 执行CPU密集型图片处理逻辑
    const result = await processImage(taskData.imagePath);
    // Worker向主线程返回结果
    parentPort?.postMessage(result);
  });
  

2. 替换Worker线程中的错误调用 #

如果你的test1.ts里误用了process.send()，直接替换为parentPort.postMessage()。parentPort是Worker Threads API提供的、用于Worker与主线程通信的标准对象。

• 错误示例：

  // Worker线程中错误调用
  process.send('处理完成');
  

• 正确替换：

  import { parentPort } from 'worker_threads';
  parentPort?.postMessage('处理完成');
  

3. 捕获Worker的详细错误信息 #

默认情况下，Worker的报错可能不会完全输出到主线程控制台，给Worker实例添加error和exit事件监听，获取完整报错细节：

// SomeOtherfile.ts中的Worker配置
const worker = new Worker('./test1.ts');
worker.on('error', (err) => {
  console.error('Worker运行报错:', err);
});
worker.on('exit', (code) => {
  if (code !== 0) {
    console.error(`Worker异常退出，退出码: ${code}`);
  }
});

这能帮你排查除process.send()之外的其他问题，比如图片处理依赖缺失、TypeScript编译错误等。

4. 验证TypeScript编译配置 #

如果项目使用TypeScript，确保Worker脚本能被正确编译，且主线程能找到编译后的文件：

• 检查tsconfig.json的outDir配置，确认编译后的test1.js路径正确；主线程中Worker的路径需指向编译后的JS文件，或使用ts-node --worker参数直接运行TS脚本（推荐先编译为JS再执行）。

5. 排查Worker线程的非法操作 #

确保test1.ts中没有执行主线程专属逻辑，比如访问Express请求对象、主线程全局变量等，这类操作在Worker线程中不存在，会导致线程异常退出。

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