Electron+React应用打包后无法自动启动Node服务问题

问题根源 #

本地执行npm run electron:start时能正常启动server/server.js，但打包为exe后失效，核心原因有三点：

1. 打包未包含server目录：当前配置仅打包build和node_modules，server文件夹被遗漏，导致exe中找不到server.js文件
2. 路径计算错误：打包后__dirname指向asar包内部路径，与开发阶段的路径结构不一致
3. 依赖系统Node环境：直接调用node命令需要用户机器提前安装Node，而打包后的Electron本身内置Node环境，无需额外依赖

修复步骤 #

1. 修改package.json，确保server目录被打包 #

在build.files数组中添加"server/**/*"，让electron-builder将server文件夹纳入安装包：

"build": {
  "appId": "electron.react.dmd",
  "productName": "DEMO",
  "files": [
    "build/**/*",
    "node_modules/**/*",
    "server/**/*" // 新增该行
  ],
  // 其余配置保持不变
}

2. 调整electron.js中的启动逻辑 #

替换原child_process.spawn调用，改用Electron内置的Node执行server.js，同时修正路径计算逻辑：

function createWindow() {
    const mainWindow = new BrowserWindow({
        width: 800,
        height: 600,
        webPreferences: {
            preload: path.join(__dirname, "preload.js"),
        },
    });

    // 修正server文件路径与启动方式
    const serverPath = path.join(app.getAppPath(), 'server', 'server.js');
    // 使用Electron内置的Node执行，避免依赖系统Node环境
    serverProcess = child_process.spawn(process.execPath, [serverPath]);

    // 添加日志监听，便于调试打包后的问题
    serverProcess.stdout.on('data', (data) => {
        console.log(`Server stdout: ${data}`);
    });

    serverProcess.stderr.on('data', (data) => {
        console.error(`Server stderr: ${data}`);
    });

    serverProcess.on('close', (code) => {
        console.log(`Server process exited with code ${code}`);
    });

    mainWindow.loadURL(!app.isPackaged ? 'http://localhost:3000' : `file://${__dirname}/../build/index.html`);

    if (!app.isPackaged) {
        mainWindow.webContents.openDevTools();
    }
}

3. 处理asar包限制（可选） #

如果server.js依赖的文件需要读写操作（无法在asar包内直接完成），可在build配置中添加asarUnpack，将server目录解压到asar包外部：

"build": {
  // 其余配置不变
  "asarUnpack": [
    "server/**/*"
  ]
}

验证修复 #

重新执行打包命令：

npm run build:package:win

运行生成的exe文件，通过Electron控制台或日志输出确认server是否正常启动。

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