升级至WiX4后Bundle安装出现不必要重启提示的排查与解决

将安装程序从WiX3升级到WiX4.0.1后，Bundle包含3个MsiPackage安装包：

• 单独依次安装每个MSI时，无重启请求
• 通过Bundle安装时，自定义THM对话框弹出“必须重启计算机才能使用软件”的提示
• 实际软件可正常运行：文件部署完成，COM组件注册正常，卸载时弹出该提示更不符合逻辑

相关Bundle源码：

<?include FD_Defines.wxi?>
<Wix xmlns="http://wixtoolset.org/schemas/v4/wxs" xmlns:bal="http://wixtoolset.org/schemas/v4/wxs/bal">
  <Bundle Name="ProductManagement" Version="$(var.CurrentVersion)" Manufacturer="ACME" UpgradeCode="my-GUID-is-here">    
    <BootstrapperApplication>
      <Payload SourceFile="Banner_small.jpg" />
      <bal:WixStandardBootstrapperApplication LicenseUrl="" Theme="hyperlinkLicense" />
    </BootstrapperApplication>

    <WixVariable Id="WixStdbaThemeXml" Value="HyperlinkTheme.xml" />
    <Variable Name="checkboxCrawler" Type="numeric" Value="0" />
   
    <Chain>
      <MsiPackage SourceFile="$(var.ProductManagementX86.TargetDir)ProductManagementX86.msi" InstallCondition="NOT VersionNT64 OR checkboxCrawler = 0" />
      <MsiPackage SourceFile="$(var.ProductCrawlerX86.TargetDir)ProductCrawlerX86.msi" InstallCondition="checkboxCrawler = 1" />
      <MsiPackage SourceFile="$(var.ProductManagementX64.TargetDir)ProductManagementX64.msi" InstallCondition="VersionNT64" />
    </Chain>

  </Bundle>
</Wix>

相关重启日志：

• ProductManagementX64.msi日志：

PROPERTY CHANGE: Adding MsiRestartManagerSessionKey property. Its value is 'b1c5274f2799dd4f9965645295e09921'.
RESTART MANAGER: Session opened.
RESTART MANAGER: Session closed.

• ProductManagementX86.msi日志：

PROPERTY CHANGE: Adding MsiRestartManagerSessionKey property. Its value is '6cb7f3141293e34c9eb68329a77f7304'.
RESTART MANAGER: Session opened.
RESTART MANAGER: Session closed.

• Bundle.exe日志：

Updating session, registration key: SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall{745E4313-4F19-4A02-9B6B-A24949300D5C}, resume: Active, restart initiated: No, disable resume: No
Applied execute package: ProductManagementX86.msi, result: 0x0, restart: None
Applied execute package: ProductManagementX64.msi, result: 0x0, restart: None
Unsetting variable 'WixStdBARestartRequired'
Apply complete, result: 0x0, restart: None, ba requested restart: No
Variable: WixCanRestart = 1
Exit code: 0x0, restarting: No

• 自定义主题逻辑问题：检查HyperlinkTheme.xml中重启提示的触发条件，是否存在WiX3到WiX4的变量名差异（比如旧变量WixRestartRequired和WiX4的WixStdBARestartRequired混淆），或者条件硬编码导致误触发。
• MSI重启属性残留：确认每个MSI是否设置了REBOOT=Force等强制重启属性，虽然单独安装时未触发，但Bundle环境下可能被Bootstrapper误判。
• WiX4兼容性bug：WiX4.0.1可能存在Bootstrapper与自定义主题的兼容性问题，导致重启状态判断错误。
• 变量状态异常：检查Bundle中是否有自定义逻辑意外修改了重启相关变量，导致主题误判重启需求。

1. 修复自定义主题判断逻辑
   打开HyperlinkTheme.xml，定位到重启提示的显示节点，确保条件仅在实际需要重启时触发。例如，将判断条件改为：

   <Condition Action="show">WixStdBARestartRequired = 1</Condition>
   

   若主题中存在硬编码的提示显示逻辑，直接移除或修改条件。

2. 强制关闭Bootstrapper重启提示
   在Bundle的bal:WixStandardBootstrapperApplication元素中添加SuppressRestartPrompt="yes"属性，强制禁用重启提示：

   <bal:WixStandardBootstrapperApplication LicenseUrl="" Theme="hyperlinkLicense" SuppressRestartPrompt="yes" />
   

3. 禁用MSI的重启请求
   在每个MsiPackage节点中添加MsiProperty，强制MSI不请求重启：

   <MsiPackage SourceFile="$(var.ProductManagementX86.TargetDir)ProductManagementX86.msi" InstallCondition="NOT VersionNT64 OR checkboxCrawler = 0">
     <MsiProperty Name="REBOOT" Value="ReallySuppress" />
   </MsiPackage>
   

   也可以直接修改MSI的Property表，添加REBOOT=ReallySuppress属性。

4. 升级WiX到最新稳定版
   WiX4.0.1可能存在已知bug，升级到最新的WiX4稳定版本，验证是否修复了该重启提示异常问题。

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