Electron-Builder NSIS 安装程序在应用运行时无法卸载旧文件的解决方案

问题背景

在使用 Electron-Builder 构建 Windows NSIS 安装程序时，用户报告了一个关键问题：当应用程序正在运行时，升级安装会失败。具体表现为安装程序弹出错误提示"xxx cannot be closed. Please close it manually and click Retry to continue"，即无法自动关闭正在运行的应用程序，导致旧版本文件无法被卸载。

问题现象分析

在 Electron-Builder 24.13.2 版本中，当用户尝试安装新版本时：

1. 如果应用程序正在运行，安装程序会显示错误对话框，提示用户手动关闭应用程序
2. 点击"重试"按钮会重复显示相同对话框
3. 点击"取消"则会提示"旧应用程序文件无法卸载"

而在之前的 24.13.1 版本中，行为是正常的：

• 安装程序会提示"xxx is running, click OK to close"
• 点击"确定"后，运行中的应用程序会被关闭，安装过程可以继续

技术原因

经过分析，这个问题源于 Windows 系统路径处理的一个细节。在 NSIS 脚本中，当检查正在运行的进程时，使用了系统路径 %SYSTEMROOT% (通常是 C:\Windows)，但路径中包含特殊字符（空格和反斜杠），需要正确使用引号包裹。

具体来说，问题出在以下代码：

nsExec::Exec '${SYSTEMROOT}\System32\cmd.exe /c tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ${_FILE}" /FO csv | ${SYSTEMROOT}\System32\find.exe "${_FILE}"'

正确的做法应该是：

!define SYSTEMROOT "$%SYSTEMROOT%"
nsExec::Exec '"${SYSTEMROOT}\System32\cmd.exe" /c tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ${_FILE}" /FO csv | "${SYSTEMROOT}\System32\find.exe" "${_FILE}"'

解决方案

这个问题在 Electron-Builder 25.0.0-alpha.4 版本中得到了修复。对于遇到此问题的用户，可以采取以下解决方案：

1. 升级到 Electron-Builder 25.0.0 或更高版本
2. 如果暂时无法升级，可以回退到 24.13.1 版本
3. 对于需要继续使用 24.13.2 版本的特殊情况，可以手动修改 NSIS 脚本，按照上述方式正确引用系统路径

最佳实践建议

1. 在开发 Electron 应用程序时，建议定期更新 electron-builder 到最新稳定版本
2. 在发布新版本前，务必测试升级场景，包括：
   • 应用程序运行时进行升级
   • 不同安装路径下的升级
   • 不同 Windows 系统版本上的升级
3. 对于企业级应用，建议建立完整的升级测试流程，确保升级过程在各种场景下都能正常工作

总结

Electron-Builder 作为 Electron 应用程序打包的重要工具，其稳定性和可靠性对应用程序的部署至关重要。这个 NSIS 安装程序在应用运行时无法卸载旧文件的问题，虽然看似简单，但反映了路径处理和进程管理中的细节重要性。通过理解问题本质和解决方案，开发者可以更好地处理类似问题，确保应用程序的平滑升级体验。