如何避免Windows Installer/MSI安装同一产品的多版本记录问题

这是个典型的Windows Installer版本管理问题，核心原因是你没有配置**Major Upgrade（大升级）**机制，导致Windows Installer把不同版本识别为独立产品，允许“并排”安装但实际覆盖了同一目录，进而出现控制面板记录与实际安装不符的情况。

要让新版本自动替换旧版本，同时保持控制面板记录与实际安装一致，最标准的做法是利用Windows Installer的Major Upgrade功能，它会自动处理旧版本的卸载和新版本的安装，确保系统中始终只有该产品的一个版本。

1. 添加MajorUpgrade元素到你的Wix Product中 #

在你的<Product>标签内添加以下代码，这是实现自动升级的核心配置：

<MajorUpgrade 
  AllowDowngrades="no" 
  AllowSameVersionUpgrades="yes" 
  RemoveExistingProducts="afterInstallInitialize" 
  DowngradeErrorMessage="A newer version of [ProductName] is already installed." />

各属性说明： #

• AllowDowngrades="no"：禁止用户安装旧版本覆盖已有的新版本，避免版本回退导致的问题
• AllowSameVersionUpgrades="yes"：允许同一版本的重新安装（比如修复安装、覆盖安装）
• RemoveExistingProducts="afterInstallInitialize"：选择在安装初始化完成后卸载旧版本，这个时机既能读取旧版本的配置信息，又能避免文件占用冲突，是比较通用的设置
• DowngradeErrorMessage：当用户尝试安装旧版本时显示的提示信息

2. 确保关键配置正确 #

• UpgradeCode必须固定：你已经设置了固定的UpgradeCode="ae9a7d6d-6c2d-446a-97d9-9dbe829d2ea8"，这非常重要——Windows Installer通过这个GUID识别属于同一产品线的不同版本，绝对不能随版本修改。
• Product Version必须更新：每次发布新版本时，必须修改Version="!(wix.PRODUCT_VERSION)"的前三位（比如从1.0.0改为1.0.1或2.0.0）。Windows Installer只识别版本号的前三位，第四位会被忽略，不触发升级逻辑。
• 组件Guid规范：
  • 对于随版本更新的组件（比如foobar.exe这类主程序文件），可以保持Guid="*"，Wix会自动生成新的Guid，确保Windows Installer正确识别为新版本组件。
  • 对于需要跨版本保留的组件（比如用户数据目录、配置文件），必须设置固定的Guid，避免旧版本卸载时删除这些重要内容。比如你的app_data_config_folder组件，应该补上固定Guid：

    <Component Guid="3f9a8c7d-1b2c-4d5e-8f9a-bcde12345678" Id="app_data_config_folder">
      <CreateFolder />
    </Component>
    

3. 修改后的完整Product片段示例 #

<Product Name="Foobar" Manufacturer="ACME Inc." Id="*" UpgradeCode="ae9a7d6d-6c2d-446a-97d9-9dbe829d2ea8" Language="1033" Codepage="1252" Version="!(wix.PRODUCT_VERSION)">
  <Package Id="*" Languages="1033" SummaryCodepage="1252" Compressed="yes" InstallerVersion="200" />
  <!-- 添加MajorUpgrade配置 -->
  <MajorUpgrade 
    AllowDowngrades="no" 
    AllowSameVersionUpgrades="yes" 
    RemoveExistingProducts="afterInstallInitialize" 
    DowngradeErrorMessage="A newer version of [ProductName] is already installed." />
  <Icon Id="foobar" SourceFile="!(wix.APPPATH)/foobar.ico" />
  <Property Id="ARPPRODUCTICON" Value="foobar" />
  <Property Id="ARPCOMMENTS" Value="Gives you full foobar powers" />
  <MediaTemplate EmbedCab="yes" CompressionLevel="high" />
  <!-- 其余目录、组件、Feature配置保持不变 -->
</Product>

4. 验证效果 #

配置完成后，编译新版本MSI并安装：

• 系统中如果已有旧版本，安装程序会自动卸载旧版本，然后安装新版本，控制面板中只会显示当前版本的记录。
• 如果用户尝试安装旧版本，会弹出你设置的错误提示，阻止安装。
• 同一版本的MSI可以正常执行修复或覆盖安装。

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