WIX安装引导程序遇并行安装挂起，如何提前锁定_MSIExecute互斥体？

这个问题我之前帮不少开发者处理过，核心就是要在正式触发MSI安装前，提前检测系统里的_MSIExecute互斥体，避免引导程序因为等待而挂起。下面是具体的实现步骤：

1. 改用自定义Bootstrapper Application（BA） #

默认的WiX Burn引导程序没有内置互斥体检测逻辑，所以你需要创建一个自定义BA，这样才能在用户点击安装按钮后、启动MSI前插入自己的检测代码。

2. 编写互斥体检测与锁定逻辑 #

在自定义BA的代码里，调用Windows API来操作_MSIExecute互斥体：

• 用CreateMutexW尝试获取互斥体的所有权
  • 如果返回的句柄有效且GetLastError()返回ERROR_ALREADY_EXISTS，说明已有其他MSI安装在运行，直接弹出提示并终止当前引导流程
  • 如果成功锁定互斥体，记得在安装完成（无论成功或失败）后释放它，避免影响后续的安装操作

示例C++代码片段 #

// 尝试锁定_MSIExecute互斥体
HANDLE hMutex = CreateMutexW(NULL, TRUE, L"_MSIExecute");
if (hMutex == NULL) {
    MessageBoxW(NULL, L"无法检测系统安装状态，请检查权限后重试", L"安装错误", MB_ICONERROR | MB_OK);
    return;
}

DWORD dwError = GetLastError();
if (dwError == ERROR_ALREADY_EXISTS) {
    // 提示用户已有安装在进行
    MessageBoxW(NULL, L"另一个安装程序正在运行，请完成后再尝试本次安装", L"安装冲突", MB_ICONERROR | MB_OK);
    CloseHandle(hMutex);
    // 终止引导程序
    ExitProcess(1);
}

// 到这里说明互斥体已锁定，继续执行安装流程...

// 安装完成后务必释放互斥体
ReleaseMutex(hMutex);
CloseHandle(hMutex);

3. 集成自定义BA到WiX Bundle项目 #

把编译好的自定义BA DLL作为Payload引入到Bundle配置中：

<Bundle>
  <BootstrapperApplicationRef Id="CustomBootstrapperApplication">
    <Payload SourceFile=".\bin\CustomBootstrapper.dll" />
  </BootstrapperApplicationRef>
  
  <!-- 你的MSIPackage等其他配置 -->
  <Chain>
    <MsiPackage SourceFile="YourApp.msi" DisplayInternalUI="yes" />
  </Chain>
</Bundle>

关键注意事项 #

• 务必释放互斥体：不管安装成功还是失败，都要在流程结束时释放_MSIExecute，否则会导致后续所有MSI安装都无法启动
• 锁定时机要准确：只在第一个MSI开始安装前锁定，所有安装完成后再释放，不要长时间持有互斥体
• 权限问题：确保引导程序有足够权限操作系统互斥体，避免因权限不足导致检测失败

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