生产环境部署Node.js Worker Threads报错：Cannot find module 'worker_threads'

看起来你遇到的问题大概率和服务器的Node.js版本或者编译配置有关，我来帮你一步步排查解决：

1. 先检查服务器的Node.js版本 #

worker_threads是Node.js的内置模块，但它的支持有明确的版本要求：

• Node.js 10.5.0 首次引入（启动时需要加--experimental-worker标志）
• Node.js 12.x 及以上成为稳定API，无需额外启动标志

先在服务器上运行命令查看当前Node版本：

node -v

如果版本低于12.x，这就是问题的核心根源！推荐用nvm（Node版本管理器）来升级到LTS版本（比如18.x或20.x），操作步骤如下：

# 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
# 重新加载shell配置（如果是zsh环境，替换为source ~/.zshrc）
source ~/.bashrc
# 安装最新LTS版本
nvm install --lts
# 设置该版本为默认Node版本
nvm alias default lts/*

升级完成后，再尝试启动项目。

2. 验证TypeScript编译配置 #

因为你的项目基于TypeScript，要确保编译后的代码能被服务器的Node版本正确识别：

• 打开本地的tsconfig.json，确认target至少设置为ES2018（对应Node.js 10+的语法支持），module设置为CommonJS（Node.js默认的模块系统），同时moduleResolution设置为Node：

{
  "compilerOptions": {
    "target": "ES2018",
    "module": "CommonJS",
    "outDir": "./build",
    "moduleResolution": "Node",
    // 其他配置项...
  }
}

• 另外，确保你安装了@types/node开发依赖，这样TypeScript才能正确识别worker_threads的类型定义：

npm install @types/node --save-dev

修改配置后，重新编译项目再部署到服务器。

3. 检查部署时的依赖安装逻辑 #

worker_threads是Node.js内置模块，不需要在package.json中添加依赖。如果你之前错误地把它当成第三方包安装，反而可能导致模块引用冲突——检查你的package.json，确保没有worker_threads这个依赖项。

4. 旧版本Node的临时启动方案（不推荐） #

如果因为环境限制无法升级服务器的Node版本（比如只能用10.x），启动项目时必须加上--experimental-worker标志：

# 直接用node启动
node --experimental-worker ./src/main.js
# 用pm2启动的话，需要传递node参数
pm2 start ./src/main.js --node-args="--experimental-worker"

但还是强烈建议升级到LTS版本，避免后续出现更多兼容性问题。

5. 排查编译后的代码 #

进入服务器的build/src目录，查看main.js里引用worker_threads的代码是否正确，比如应该是：

// CommonJS写法
const { Worker, isMainThread } = require('worker_threads');
// 或者ES模块写法（如果你的tsconfig配置了ES模块）
import { Worker, isMainThread } from 'worker_threads';

如果编译后的代码出现错误的路径或语法，那可能是tsconfig的moduleResolution配置有误，调整为Node即可解决。

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