WiX v4小版本升级异常咨询：大版本升级正常

问题概述 #

在WiX v4环境中遇到小版本升级异常，但大版本升级可正常执行。安装程序提示成功，但运行已安装应用时出现报错，仿佛升级未完成；而全新安装与大版本升级均正常。

当前实现 #

<Upgrade Id="$(var.UpgradeCode)">
<UpgradeVersion Minimum="$(var.InitialVersion)"
   Maximum="$(var.ProductVersion)"
   Property="PREVIOUSVERSIONSINSTALLED"
   IncludeMinimum="yes"
   IncludeMaximum="yes" />
</Upgrade>

<InstallExecuteSequence>
   <RemoveExistingProducts After="InstallInitialize"/>
</InstallExecuteSequence>

版本详情 #

• 初始版本（基础版）：10.3.0.0
• 当前安装版本：10.3.0.106

安装配置详情 #

• 使用WiX bundle打包MSI及前置依赖
• 全新安装运行完全正常
• 大版本升级（修改产品代码时）符合预期
• 小版本升级（仅修改版本号，其余保持不变）疑似失败

特定需求 #

需实现如下逻辑：

1. 检测升级类型为大版本还是小版本
2. 根据检测结果执行对应类型的升级

问题解答 #

1. 为何小版本升级失败但大版本升级正常？ #

核心原因是当前升级配置不匹配小版本升级的Windows Installer行为：

• RemoveExistingProducts时机错误：将RemoveExistingProducts放在InstallInitialize之后的配置，适合需要完全卸载旧版本的大版本升级。但小版本升级是增量更新，强行提前移除旧产品会导致文件覆盖不完整、组件状态异常，比如旧文件被删除后新文件未正确复制，或注册表/组件注册残留。
• UpgradeVersion配置问题：IncludeMaximum="yes"会将当前版本纳入检测范围，导致安装程序误判自身为旧版本，触发不必要的逻辑冲突。
• 组件GUID违规：如果小版本升级时修改了组件GUID，Windows Installer会将新组件视为全新组件，旧组件残留，应用运行时调用旧组件报错。小版本升级要求组件GUID保持不变（除非组件功能发生重大变更）。

2. 基于版本检测实现条件升级逻辑的推荐方案 #

通过版本解析区分大/小版本，配置不同的升级序列：

步骤1：检测旧版本并定义升级类型属性

<!-- 检测旧版本，排除当前版本 -->
<Upgrade Id="$(var.UpgradeCode)">
  <UpgradeVersion Minimum="$(var.InitialVersion)" Maximum="$(var.ProductVersion)" 
                  Property="PREVIOUSVERSIONSINSTALLED" IncludeMinimum="yes" IncludeMaximum="no" />
  <UpgradeVersion Minimum="$(var.ProductVersion)" Property="NEWERVERSIONINSTALLED" IncludeMinimum="yes" />
</Upgrade>

<!-- 设置大版本升级标记：旧版本主版本号≠当前主版本号 -->
<SetProperty Id="IS_MAJOR_UPGRADE" Value="1" 
             After="FindRelatedProducts">
  PREVIOUSVERSIONSINSTALLED AND (VersionMsi(PREVIOUSVERSIONSINSTALLED, 0) != VersionMsi($(var.ProductVersion), 0))
</SetProperty>

<!-- 设置小版本升级标记：旧版本主版本号=当前主版本号 -->
<SetProperty Id="IS_MINOR_UPGRADE" Value="1" 
             After="FindRelatedProducts">
  PREVIOUSVERSIONSINSTALLED AND (VersionMsi(PREVIOUSVERSIONSINSTALLED, 0) = VersionMsi($(var.ProductVersion), 0))
</SetProperty>

步骤2：条件执行不同的升级序列

<InstallExecuteSequence>
  <!-- 大版本升级：完全卸载旧版本后安装 -->
  <RemoveExistingProducts After="InstallInitialize" Condition="IS_MAJOR_UPGRADE" />
  <!-- 小版本升级：安装完成后移除旧版本残留（或改为增量更新逻辑） -->
  <RemoveExistingProducts After="InstallFinalize" Condition="IS_MINOR_UPGRADE" />
</InstallExecuteSequence>

小版本升级额外配置

在Product元素中启用次要升级模式：

<Product Id="*" Name="YourApp" Language="1033" Version="$(var.ProductVersion)" 
         Manufacturer="YourCompany" UpgradeCode="$(var.UpgradeCode)"
         MinorUpgrade="yes">

3. WiX v4中小版本升级的已知注意事项 #

• 组件GUID必须稳定：小版本升级时，除非组件功能发生重大变更（如接口修改），否则组件GUID不能修改，否则会导致旧组件残留。
• 文件版本严格递增：更新的文件版本必须高于旧版本，否则Windows Installer会跳过替换。若需替换同版本文件，需给File元素添加ForceInstall="yes"属性（WiX v4新增）。
• Bundle升级配置：使用Bundle时，小版本升级需保持Bundle的UpgradeCode不变，版本号递增，并配置RelatedBundle元素检测旧Bundle版本。
• 自定义动作适配：小版本升级时，自定义动作的执行时机需调整，避免执行卸载旧版本时的清理逻辑，导致新安装的文件/注册表被误删。
• 日志排查：小版本升级异常时，务必生成安装日志（msiexec /i setup.msi /l*v install.log），通过日志查看文件替换、组件注册、RemoveExistingProducts执行情况，定位具体问题。

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