打包后的Electron应用中Node.js Express服务子进程无法启动

1. 优先排查子进程调用逻辑错误 #

绝大多数此类问题都是开发环境和打包环境的执行上下文差异导致的，常见错误点：

• 不要直接调用node命令启动服务：开发环境本地安装了Node.js可以识别node命令，打包后用户环境没有全局Node.js，会直接启动失败。请用Electron自带的Node运行时启动服务，替换spawn('node', [入口文件路径])为spawn(process.execPath, [入口文件路径])。
• 所有路径必须用绝对路径：不要使用相对路径作为服务入口路径、子进程工作目录（cwd参数），需要通过Electron提供的API拼接打包后的真实绝对路径：

const { spawn } = require('child_process');
const { app } = require('electron');
const path = require('path');

// 示例：express服务打包后存放在应用的resources/express-server目录下
const serverEntryPath = path.join(process.resourcesPath, 'express-server', 'index.js');
const serverCwd = path.dirname(serverEntryPath);

const serverProcess = spawn(process.execPath, [serverEntryPath], {
  cwd: serverCwd,
  // 开发排查阶段可将stdio设为inherit，直接在控制台打印子进程日志
  stdio: 'ignore',
  detached: process.platform !== 'win32'
});

2. 确认Express服务文件被完整打包 #

即使你关闭了asar打包，默认配置下electron-builder只会打包应用主进程、渲染进程相关的依赖，你的独立Express服务模块不会被自动打包进应用包，需要在electron-builder.yml中手动配置extraResources将服务目录打包到应用资源目录：

extraResources:
  - from: "./本地express服务的目录路径" # 你项目里存放独立express服务的文件夹相对路径
    to: "express-server" # 打包后在resources目录下生成的文件夹名
    filter:
      - "**/*"
      - "!node_modules/.bin" # 可选过滤不需要的文件

打包完成后可以直接打开打包输出目录的resources/express-server文件夹，手动执行node index.js验证服务本身是否可以正常启动，排除服务代码本身的错误。

3. 打印子进程日志定位具体错误 #

如果上述配置都修改后仍然无法启动，直接将子进程的输出日志写入本地文件，查看具体报错信息：

const fs = require('fs');
const logPath = path.join(app.getPath('userData'), 'express-server-log.txt');
const logFd = fs.openSync(logPath, 'a');

const serverProcess = spawn(process.execPath, [serverEntryPath], {
  cwd: serverCwd,
  stdio: ['ignore', logFd, logFd]
});

启动打包后的应用后，前往Electron应用的userData目录找到日志文件，即可看到是缺少依赖、端口占用还是路径错误等具体问题。

4. 其他常见问题排查 #

• 如果你的Express服务依赖了包含二进制文件的Node模块，需要在electron-builder配置中开启npmRebuild: true，针对打包目标平台重新编译二进制模块，避免跨平台兼容性问题。
• 不要将Express服务的代码放在asar包内运行，即使你开启了asar打包，也要把服务目录配置到extraResources中，放到asar包外运行，避免路径读取异常。

内容的提问来源于stack exchange，提问作者Chukwuezugo Okpara