MSI安装程序卸载时无法移除文件的问题求助

下面是针对该问题的具体排查和解决步骤：

• 严格遵守WiX组件规则
  Windows Installer的组件引用计数机制依赖严格的组件规则：每个组件只能包含一个核心主文件（如EXE、DLL），附属资源（配置文件、图标等）可放在同一组件内。如果一个组件包含多个主文件，或者组件路径/主文件频繁变更但GUID未同步更新，会导致Installer无法正确跟踪组件状态，卸载时就不会删除文件。

• 检查并确认组件KeyPath设置
  每个组件必须指定有效的KeyPath（默认是组件内第一个文件），它是Windows Installer识别组件是否存在的依据。如果KeyPath被错误设置到文件夹或非核心文件，会导致组件状态判断异常。可以显式指定KeyPath确保正确性：

  <Component Id="MyAppComponent" Guid="*">
    <File Id="MyAppExe" Source="$(var.MyApp.TargetPath)" KeyPath="yes" />
  </Component>
  

• 移除不必要的Permanent属性
  若组件设置了Permanent="yes"，该组件会被标记为永久保留，卸载时不会被删除。检查你的组件定义，确保没有意外开启这个属性：

  <!-- 正确写法：不设置Permanent或设为no -->
  <Component Id="MyAppComponent" Guid="*" Permanent="no">
  

• 使用WiX自动生成稳定GUID
  不要手动维护组件GUID，改用Guid="*"让WiX自动生成。WiX会根据组件的安装路径和KeyPath文件的哈希值生成固定GUID——只要组件路径和KeyPath文件不变，每次构建都会生成同一个GUID，既不用手动修改，又能保证组件识别的一致性。

• 通过卸载日志定位问题
  生成卸载日志排查具体原因，打开命令提示符运行：

  msiexec /x {你的MSI产品GUID} /l*v uninstall.log
  

  日志中搜索Component:或RemoveFiles相关条目，查看是否有组件引用计数异常、KeyPath缺失等错误提示。

• 检查组件是否被其他产品共享
  如果组件被其他MSI安装包共享，Windows Installer的引用计数会大于1，卸载时不会删除文件。可在注册表HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Installer\UserData\S-1-5-18\Components下搜索组件GUID，确认是否有多个产品引用该组件。

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