Node/TypeScript中Worker Threads未执行问题排查求助

1. 核心问题：Worker函数未触发执行 #

你在worker.ts中定义了worker异步函数，但没有主动调用它——Worker线程启动后只会加载文件，不会自动执行文件内的函数。

修改worker.ts，手动调用函数并处理异步错误：

import { parentPort } from "worker_threads";

async function worker() {
  console.log("started");
  parentPort.postMessage("fixed!");
}

// 主动调用函数，同时捕获异步错误避免线程静默崩溃
worker().catch(err => {
  console.error("Worker执行异常:", err);
  parentPort?.postMessage({ error: err.message });
});

2. 路径解析可能存在偏差 #

在worker.js中，path.resolve(__dirname, workerData.path)的路径计算可能和你的实际目录结构不匹配。比如__dirname对应src/core/utils，结合../../adapters/worker.ts会解析为src/adapters/worker.ts，如果这个路径不存在，require会失败但可能没有明显报错。

可以在worker.js中添加日志验证路径：

const path = require("path");
const { workerData } = require("worker_threads");

const targetPath = path.resolve(__dirname, workerData.path);
console.log("待加载的Worker TS路径:", targetPath); // 检查路径是否正确

require("ts-node").register();
require(targetPath);

3. ts-node 注册适配ES模块（可选） #

如果你的项目在package.json中设置了type: "module"，ts-node默认配置可能无法正确处理ES模块语法。可以修改worker.js的注册代码：

const path = require("path");
const { workerData } = require("worker_threads");

require("ts-node").register({
  esm: true,
  transpileOnly: true // 生产环境建议先预编译TS为JS，替代实时编译
});
require(path.resolve(__dirname, workerData.path));

4. 增强主线程的调试能力 #

当前create_worker的错误处理仅监听了基础事件，无法捕获Worker的控制台输出。可以开启Worker的stdout捕获，方便排查问题：

import { Worker } from "worker_threads";

const create_worker = (file: string, workerData: {}) =>
  new Promise<void>((resolve, reject) => {
    const worker = new Worker(file, {
      workerData: workerData,
      stdout: true // 开启标准输出捕获
    });

    // 打印Worker的控制台日志
    worker.stdout.on("data", (data) => {
      console.log("[Worker 日志]", data.toString().trim());
    });

    worker.on("message", resolve);
    worker.on("error", reject);
    worker.on("exit", (code) => {
      if (code !== 0) reject(new Error(`Worker退出码: ${code}`));
    });
  });

export default create_worker;

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