Electron-builder构建后Mac端应用无法启动问题求助

使用Node.js 18、npm、TypeScript、Sequelize、sequelize-typescript、Sqlite3、React技术栈开发桌面应用，通过electron-builder构建后，release和build文件夹正常生成，但Mac系统中启动应用无任何反应。已处理构建时的提示，尝试过检查依赖版本、执行相关脚本、迁移Sqlite文件等方案均无效，同时需要适配Windows端exe生成。

相关目录结构：

• 工作目录：工作目录概览
• Release文件夹：Release文件夹详情

已提供构建脚本、根目录package.json及release/app/package.json。

Mac端启动无响应排查 #

1. 捕获启动日志 #

打开Mac控制台（Console.app），搜索应用名称查看启动报错，这是定位问题的核心步骤。

2. 确保Sqlite3适配Electron #

Sqlite3需针对Electron平台编译，执行以下命令重新安装：

npm install sqlite3 --build-from-source --runtime=electron --target=<你的Electron版本> --disturl=https://atom.io/download/electron

同时检查Sequelize连接配置，使用app.getAppPath()动态获取数据库路径，避免硬编码导致文件找不到：

import { app } from 'electron';
import { join } from 'path';

const dbPath = join(app.getAppPath(), 'database.sqlite');

3. 排查主进程异常 #

在主进程代码开头添加全局异常捕获，定位未处理的错误：

process.on('uncaughtException', err => console.error('主进程未捕获异常:', err));
process.on('unhandledRejection', (reason, promise) => console.error('未处理Promise拒绝:', reason, promise));

确认根目录package.json的main字段指向正确的编译后主进程文件（如release/app/dist/main/index.js）。

4. 验证依赖打包完整性 #

检查release/app/package.json的dependencies是否包含sequelize、sequelize-typescript、sqlite3等生产依赖。若缺失，调整electron-builder配置避免误排除：

"build": {
  "files": [
    "release/app/**/*"
  ],
  "extraResources": [
    {
      "from": "node_modules/sqlite3/lib/binding/",
      "to": "node_modules/sqlite3/lib/binding/"
    }
  ]
}

Windows端EXE生成适配 #

1. 配置electron-builder Windows目标 #

在根目录package.json的build字段中添加Windows配置：

"build": {
  "win": {
    "target": "nsis",
    "icon": "build/icon.ico"
  },
  "nsis": {
    "oneClick": false,
    "allowToChangeInstallationDirectory": true
  }
}

2. 安装Windows编译依赖 #

执行以下命令安装编译环境：

npm install --global windows-build-tools

重新安装Sqlite3适配Electron：

npm install sqlite3 --build-from-source --runtime=electron --target=<你的Electron版本>

3. 路径适配 #

使用path.join()拼接文件路径，避免硬编码分隔符导致的Windows路径错误。

通用构建检查 #

1. 清理缓存后重新构建：

rm -rf node_modules build release
npm install
npm run build

2. 确认TypeScript编译无错误，输出文件路径与打包配置一致。
3. 先在开发模式（npm run dev）验证应用正常运行，排除代码本身问题。

内容的提问来源于stack exchange，提问作者Ezequiel Salomon