在CentOS7通过electronuserland/builder:wine打包Windows应用启动报错求助

问题场景与报错 #

• 运行环境：Linux CentOS 7，使用electronuserland/builder:wine镜像构建Windows Electron应用
• 异常现象：exe文件可正常安装，但启动时触发主进程JavaScript异常，核心报错：

  C:\Users ...\AppData Loc... 26f0978b-dd24-4534-a6e6-7135af017806.tmp.node is not a valid Win32 application

• 调用栈最终指向ffi-napi模块的加载逻辑（路径：C:\Program Files\App\resources\app.asar\node_modules\ffi-napi\lib\bindings.js）

可行解决方案 #

1. 明确指定Windows目标架构 #

构建时强制指定目标架构，避免与运行环境不匹配：

electron-builder --win --x64  # 针对64位Windows系统
# 或针对32位系统执行：
# electron-builder --win --ia32

使用Docker镜像时，确认镜像环境与目标架构一致，electronuserland/builder:wine默认支持x64架构。

2. 重新编译native模块 #

ffi-napi是原生模块，跨平台构建时需确保生成适配Windows的二进制文件：

• 在package.json中添加编译脚本：

  "scripts": {
    "rebuild": "electron-rebuild -f -w ffi-napi"
  }
  

• 构建前执行清理+重新编译流程：

  rm -rf node_modules && npm install && npm run rebuild
  

3. 调整asar打包配置 #

部分原生模块无法在asar包内正常加载，需将相关模块排除在外：
在package.json的build字段中添加：

"build": {
  "asarUnpack": [
    "node_modules/ffi-napi/**/*",
    "node_modules/ref-napi/**/*"
  ]
}

此配置会将ffi-napi及其依赖的ref-napi文件放在app.asar.unpacked目录，避免asar打包导致的加载异常。

4. 更新或验证Docker镜像环境 #

拉取最新版的electronuserland/builder:wine镜像，确保wine环境稳定：

docker pull electronuserland/builder:wine

旧版本wine可能导致编译出的Windows二进制文件不兼容。

内容的提问来源于stack exchange，提问作者andy ying