Electron打包生产后执行node index.js报错 开发环境运行正常

问题现象 #

• 开发环境通过electron-forge start调试时，所有功能运行正常
• 打包为生产可执行文件后，点击绑定子进程执行逻辑的按钮，会抛出MODULE_NOT_FOUND错误，报错提示无法识别系统node模块路径、无法定位项目内的index.js文件，错误堆栈显示node会默认在用户系统主目录（示例中为/home/myUser/）下查找目标脚本。
• 触发报错的按钮绑定原始逻辑：

const { exec } = require("child_process");
let myBtn = document.getElementById('my-btn');

myBtn.addEventListener('click', (e) => {
  e.preventDefault();
  exec("node index.js", (error, data, getter) => {
    if(error){
      console.log("error",error.message);
      return;
    }
    if(getter){
      console.log("data",data);
      return;
    }
    console.log("data",data);
  });
});

• 原始报错堆栈：

error Command failed: node index.js
internal/modules/cjs/loader.js:1068
throw err;
^

Error: Cannot find module '/home/myUser/index.js'
  at Function.Module._resolveFilename (internal/modules/cjs/loader.js:1065:15)
  at Function.Module._load (internal/modules/cjs/loader.js:911:27)
  at Function.executeUserEntryPoint [as runMain] (internal/modules/run_main.js:60:12)
  at internal/main/run_main_module.js:17:47 {
code: 'MODULE_NOT_FOUND',
requireStack: []
}

核心根因 #

• 开发环境下，进程工作目录默认为项目根目录，相对路径index.js可以被正常解析，同时开发机已安装全局node，因此命令可以正常执行。
• 生产打包后存在两个关键差异：
  • 应用启动时的工作目录默认对应用户系统主目录，而非应用内部资源存放路径，裸相对路径index.js会被解析为用户主目录下的文件，自然无法找到打包在应用内部的目标脚本
  • 生产环境用户机器未必预装全局node，直接调用node命令本身就存在执行失败的风险

排查与解决步骤 #

1. 修正脚本路径解析逻辑
   • 禁止使用裸相对路径引用内部脚本，通过Electron提供的全局路径属性拼接绝对路径：
     • 使用process.resourcesPath获取打包后应用资源的实际存放目录，该属性会自动适配不同操作系统的应用资源存放路径，不需要额外编写跨平台的路径判断逻辑
     • 结合path模块拼接目标脚本的绝对路径，不受应用启动工作目录偏移的影响
2. 配置打包资源规则
   • index.js不属于Electron默认打包的应用入口文件，需要在Forge配置的packagerConfig中通过extraResource字段声明将该脚本纳入打包范围，避免打包后应用内部不存在对应文件。调整后的Forge配置示例：

   "config": {
     "forge": {
       "packagerConfig": {
         "extraResource": [
           "./index.js"
         ]
       },
       "makers": [/* 原有makers配置保持不变 */]
     }
   }
   

3. 优化子进程执行逻辑
   • 放弃直接调用系统全局node的写法，改用Electron内置的node可执行文件（通过process.execPath获取路径）作为执行器，完全不依赖用户机器的node环境配置，避免跨环境的node路径识别问题
   • 优先使用execFile替代exec：可以避免shell解析带来的路径转义、命令注入风险，精准传递脚本路径参数
   • 调整后的可正常运行的代码示例：

   const { execFile } = require("child_process");
   const path = require("path");
   
   let myBtn = document.getElementById('my-btn');
   myBtn.addEventListener('click', (e) => {
     e.preventDefault();
     // 解析打包后index.js的绝对路径
     const targetScriptPath = path.join(process.resourcesPath, "app", "index.js");
     // 复用Electron内置的node可执行文件，无需依赖系统全局node
     const executorPath = process.execPath;
     execFile(executorPath, [targetScriptPath], (error, stdout, stderr) => {
       if(error){
         console.log("error", error.message);
         return;
       }
       if(stderr){
         console.log("stderr", stderr.toString());
         return;
       }
       console.log("stdout", stdout.toString());
     });
   });
   

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