Electron v21.3.0主进程无法使用worker_threads模块问题求助

数据老陈

2026-7-21

解决方案：Electron v21.3.0 + Squirrel打包后Worker线程parentPort未定义问题

核心原因

这个问题仅出现在Squirrel打包后的环境，本质是打包过程中Worker脚本的加载路径异常、asar打包的只读限制，或是旧版本Electron与Worker线程的兼容bug，导致worker_threads模块的parentPort无法正确初始化。

分步解决方法

1. 修复Worker脚本的路径引用

开发环境下的相对路径在打包后可能失效，需用Electron的app.getAppPath()拼接绝对路径来加载Worker：

主进程创建Worker的代码：

const { Worker } = require('worker_threads');
const path = require('path');
const { app } = require('electron');

// 拼接打包后Worker脚本的绝对路径
const workerScriptPath = path.join(app.getAppPath(), 'myWorker.js');
const worker = new Worker(workerScriptPath, {
  workerData: {}, // 按需传递初始化数据
  env: process.env
});

2. 调整asar打包配置（如果启用asar）

Electron Forge默认用asar打包，而Worker线程需要读取可写的脚本文件，需将Worker脚本从asar包中单独解压：

在forge.config.js中修改配置：

module.exports = {
  packagerConfig: {
    asar: true,
    // 指定Worker脚本需要被解压
    asarUnpack: ['myWorker.js']
  },
  makers: [
    {
      name: '@electron-forge/maker-squirrel',
      config: {
        // 你的Squirrel打包配置
      }
    }
  ]
};

3. 验证Worker线程的运行环境

在Worker脚本中添加环境判断，避免脚本被错误执行在主进程：

myWorker.js代码：

const { isMainThread, parentPort } = require('worker_threads');

// 确保脚本在Worker线程中运行
if (isMainThread) {
  throw new Error('该脚本必须作为Worker线程运行');
}

// 后续使用parentPort的逻辑
parentPort.on('message', (message) => {
  // 处理消息
  parentPort.postMessage('已收到消息');
});