Azure DevOps中electron-builder打包Windows安装包失败求助

一、优先处理磁盘空间不足的问题 #

剩余仅39.74MB磁盘空间是核心高危因素，Electron-Builder打包过程需要缓存大量依赖（如Electron二进制文件、NSIS工具链），磁盘满会直接导致进程无法写入临时文件、执行编译命令，甚至引发进程崩溃（退出码null大概率和资源不足相关）。

• 必须增加代理磁盘空间：39MB完全不足以支撑Electron打包流程，至少需要预留数GB空间才能保证正常运行。
• 临时应急步骤：在流水线中添加清理缓存的环节，手动删除/home/vsts_azpcontainer/.cache/electron-builder目录，或执行npm cache clean --force清理npm缓存，释放部分空间后重试打包。

二、获取更详细的错误日志 #

当前DEBUG=electron-builder的日志级别不够，需要进一步细化：

• 设置环境变量DEBUG=electron-builder,electron-builder:*，输出所有子模块的调试信息，包括NSIS调用的完整过程。
• 手动调用NSIS工具输出详细日志：执行/home/vsts_azpcontainer/.cache/electron-builder/nsis/nsis-3.0.4.1/linux/makensis -V4（-V4为最高日志级别），直接查看该进程的具体报错。
• 检查Azure DevOps系统级日志：查看代理的磁盘IO、内存占用、进程崩溃记录，这些底层错误可能不会被Electron-Builder的日志捕获。

三、排查NSIS工具链与OS版本的兼容性 #

OS版本从6.5.0-1022-azure更新到6.5.0-1025-azure，可能导致预编译的NSIS二进制文件不兼容：

• 删除NSIS缓存目录/home/vsts_azpcontainer/.cache/electron-builder/nsis，让Electron-Builder重新下载适配当前OS版本的NSIS工具链。
• 在package.json中指定更高版本的NSIS：添加配置"build": {"nsis": {"version": "3.0.5"}}，更新到最新稳定版的NSIS工具链。
• 检查系统依赖：NSIS运行需要libgtk-3-0、libx11-xcb1等系统库，OS更新可能移除了这些依赖，需手动安装缺失的库。

四、其他排查方向 #

• 回滚OS版本：若条件允许，临时切换回6.5.0-1022-azure的代理镜像，验证是否为OS更新导致的兼容性问题。
• 本地模拟环境：在本地搭建与Azure代理相同OS版本、磁盘空间受限的环境，复现打包流程，便于调试细节。
• 检查权限配置：确认流水线代理用户对/home/vsts_azpcontainer/.cache/electron-builder目录有读写权限，权限不足也可能导致进程执行失败。

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