Wix Burn引导程序设置重启未生效，如何实现关闭时触发重启？

问题根源 #

从你的日志可以明确两点核心问题：

• Burn已经识别到重启需求（restart: Required），但你的BA没有在应用完成阶段主动请求执行重启（ba requested restart: No）
• 你在OnShutdown中设置BOOTSTRAPPER_SHUTDOWN_ACTION.Restart时，Burn内部并没有预存的重启计划（Planned to restart already: No）——这个枚举值的作用是让Burn执行已经计划好的重启，而非主动发起新的重启请求，所以当前设置不会生效。

可行解决方案 #

方案1：在OnApplyComplete阶段直接触发重启

这是Burn官方推荐的标准流程，当用户确认需要重启后，直接调用Burn引擎的重启方法：

// 在OnApplyComplete事件处理逻辑中
if (ea.Restart == ApplyRestart.RestartRequired && restartNeeded) // restartNeeded为用户选择的结果
{
    Engine.Log(LogLevel.Error, "User agreed to restart, initiating system reboot.");
    Engine.Restart(); // 由Burn处理重启的权限验证、进程清理等逻辑
}

这种方式完全遵循Burn的生命周期设计，比手动调用系统API更安全，也能保证引导程序的正常退出流程。

方案2：手动调用Windows系统API触发重启

如果必须在Shutdown阶段处理，可以直接调用Windows系统API实现重启（需要引导程序以管理员权限运行，这通常是Burn的默认配置）：
首先导入系统API：

using System.Runtime.InteropServices;

[DllImport("user32.dll", SetLastError = true)]
private static extern bool ExitWindowsEx(uint uFlags, uint dwReason);

private const uint EWX_REBOOT = 0x00000002;
private const uint EWX_FORCE = 0x00000004; // 强制终止未响应进程，慎用

然后在OnShutdown中调用：

private void OnShutDown(object sender, ShutdownEventArgs args)
{
    if (restartNeeded)
    {
        Engine.Log(LogLevel.Error, "Initiating system restart via Windows API.");
        ExitWindowsEx(EWX_REBOOT, 0); // 不带FORCE会给所有进程发送关闭通知
    }
}

注意：EWX_FORCE会强制终止未响应进程，可能导致数据丢失，仅在必要场景下使用。

额外排查点 #

• 确认你的ExePackage确实返回了0退出码，Burn才能触发scheduleReboot逻辑
• 检查引导程序是否以管理员权限运行，系统重启操作需要管理员权限
• 如果用户选择稍后重启，建议在退出时显示明确提示，告知用户需手动重启系统

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