Worker Thread引用外部文件报错：无法找到模块问题排查

核心问题：路径解析逻辑不匹配 #

你用./thread/test.js创建Worker时报错，本质是TypeScript编译后的文件路径和你写的源文件相对路径不匹配。Node.js处理Worker路径时，是基于编译后的当前模块文件位置去查找，而不是你写的service.ts的位置。但__filename指向的是编译后service.js的绝对路径，所以Node能精准定位，不会出错。

具体排查和解决步骤 #

1. 检查编译后的文件结构 #

• 打开tsconfig.json找outDir配置，确认编译后的文件输出目录（比如dist/）。假设src/service.ts编译后是dist/service.js，那你写的./thread/test.js会被解析成dist/thread/test.js。
• 查看src/thread/test.js是否被同步到对应输出目录的thread/文件夹下。TypeScript默认只处理.ts文件，纯.js文件不会自动复制到输出目录，这是常见的触发问题的原因。

2. 改用绝对路径拼接（最稳妥解法） #

用Node的path模块基于__dirname拼接绝对路径，不管编译后文件在哪，都能准确找到目标文件：

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

const workerPath = path.join(__dirname, './thread/test.js');
const worker = new Worker(workerPath);

3. 配置TypeScript同步纯JS文件 #

如果想让test.js自动跟随编译后的文件结构输出，修改tsconfig.json的include配置，把JS文件也纳入处理范围：

{
  "include": ["src/**/*.ts", "src/**/*.js"]
}

这样TypeScript编译时会把src/thread/test.js复制到输出目录的对应位置，保持和源目录一致的结构。

4. 检查进程启动的工作目录 #

如果启动Node进程时的工作目录不是项目根目录或src/，相对路径会基于启动目录解析，导致找不到文件。可以在service.ts中添加console.log(process.cwd())查看当前工作目录，要么切换到正确目录启动，要么直接使用绝对路径。

结合配置文件的额外检查 #

• 查看package.json的启动脚本，比如如果是node dist/service.js，工作目录是项目根目录，Worker路径是基于dist/service.js的位置解析，而非根目录，别混淆路径层级。
• 确认tsconfig.json的rootDir和outDir配对，保证源目录和输出目录结构一致：

{
  "rootDir": "./src",
  "outDir": "./dist"
}

内容的提问来源于stack exchange，提问作者Alex Ahlgreen Westergaard