Electron打包未包含服务端导致exe/dmg无法正常运行问题求助

问题核心原因 #

你当前的问题有两个核心点：一是electron-builder的打包规则没有包含Server目录的相关文件，二是生产环境没有像开发环境那样，在Electron启动时同步启动Node后端服务，同时React开发环境的代理配置在生产环境不生效。以下是完整修改方案：

步骤1：修改electron-builder打包配置，包含服务端文件 #

找到根目录package.json的build.files数组，新增Server目录的匹配规则，确保服务端代码被打包进安装包：

"build": {
  "extends": null,
  "appId": "com.example.electron-cra",
  "files": [
    "dist/**/*",
    "build/**/*",
    "node_modules/**/*",
    "package.json",
    "server/**/*" // 新增这行，把整个服务端目录打包
  ],
  "directories": {
    "buildResources": "assets"
  }
}

步骤2：修改Electron主进程代码，启动时自动运行后端服务 #

编辑public/main.js，新增子进程启动服务端的逻辑，同时适配开发、生产环境的路径差异：

const { app, BrowserWindow } = require('electron')
const path = require('path')
const { spawn } = require('child_process')
const isDev = require('electron-is-dev')

let serverProcess = null

// 保留你原来的创建窗口逻辑
function createWindow () {
  const mainWindow = new BrowserWindow({
    width: 1200,
    height: 800,
    webPreferences: {
      nodeIntegration: true,
      contextIsolation: false
    }
  })

  const startUrl = isDev 
    ? 'http://localhost:3000' 
    : path.join(__dirname, 'index.html')
  mainWindow.loadURL(startUrl)
}

// 新增：启动后端服务逻辑
function startServer() {
  let serverPath
  let nodePath = process.execPath // 生产环境复用Electron自带的Node运行时

  if (isDev) {
    serverPath = path.join(__dirname, '../server/server.js')
    nodePath = 'node' // 开发环境用本地Node
  } else {
    // 生产环境服务端路径，对应打包后的resources目录
    serverPath = path.join(process.resourcesPath, 'server/server.js')
  }

  // 启动服务，生产环境直接运行server.js，不使用开发用的nodemon
  serverProcess = spawn(nodePath, [serverPath], {
    cwd: isDev ? path.join(__dirname, '../server') : path.join(process.resourcesPath, 'server'),
    stdio: 'ignore' // 生产环境可关闭日志，排查问题时改为'pipe'即可
  })

  // 应用退出时杀掉服务端进程，避免后台残留
  app.on('before-quit', () => {
    if (serverProcess) serverProcess.kill()
  })
}

app.whenReady().then(() => {
  startServer() // 先启动服务再创建窗口
  createWindow()

  app.on('activate', function () {
    if (BrowserWindow.getAllWindows().length === 0) createWindow()
  })
})

// 保留原有窗口关闭逻辑
app.on('window-all-closed', function () {
  if (process.platform !== 'darwin') app.quit()
})

步骤3：调整请求和依赖配置 #

1. 前端请求地址直接写完整路径http://localhost:3001/xxx，不要用相对路径，生产环境React的proxy配置不会生效
2. 可以把Server目录package.json里的nodemon移到devDependencies，生产环境不需要这个热重载工具

步骤4：调整打包命令 #

修改根目录package.json的electron:build命令，确保打包前自动安装服务端的生产依赖：

"scripts": {
  // 其余原有命令保留
  "electron:build": "cd server && yarn install --production && cd ../ && yarn build && electron-builder -c.extraMetadata.main=build/main.js"
}

可选注意项 #

如果你的Mongoose连接的是本地MongoDB服务，需要额外处理MongoDB的打包逻辑，或者改为连接云数据库，否则用户本地未安装MongoDB时服务端会启动失败。

改完后先运行yarn electron:serve验证逻辑正常，再执行yarn electron:build打包即可，生成的安装包打开效果和开发环境完全一致。

内容的提问来源于stack exchange，提问作者Jalen Brown