管理员权限下Wix Installer命令行安装路径错误问题

问题背景 #

我用Wix构建了一款数据更新安装程序，核心逻辑是通过环境变量ENVVAR获取已有产品的安装路径，将数据文件部署到[%ENVVAR]\NewData目录。常规安装（双击MSI或执行msiexec /i filename.msi）完全正常，但使用提升权限执行msiexec /a filename.msi时，文件被错误安装到D:\根目录（非产品所在磁盘）。

我的Wix核心代码如下：

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi" xmlns:util="http://schemas.microsoft.com/wix/UtilExtension" xmlns:netfx="http://schemas.microsoft.com/wix/NetFxExtension">
<?include InstallVariables.wxi ?>
<Product Id="*" Name="Product Name" Manufacturer="My Company" Version="$(var.Version)" UpgradeCode="guidgoeshere" Language="1033">
<Package Description="Description $(var.Version)" Comments="Install package for my product." InstallerVersion="300" Compressed="yes" InstallScope="perMachine"/>
<Media Id="1" Cabinet="Cabname.cab" EmbedCab="yes" CompressionLevel="high"/>
<SetDirectory Id="PATHMAP" Value="[%ENVVAR]\NewData" Sequence="first" />
<!-- Describe the folder layout here. -->
<Directory Id="TARGETDIR" Name="SourceDir">
<Directory Id="PATHMAP" FileSource="..\New Files">
<Component Id="File1" Guid="guidgoeshere">
<RemoveFile Id="Remove_File1File" Name="$(var.File1Pattern)" On="both" />
<File Id="File1File" Name="$(var.File1)" Vital="yes" KeyPath="yes" />
</Component>
<Component Id="File2" Guid="guidgoeshere">
<RemoveFile Id="Remove_File2File" Name="$(var.File2Pattern)" On="both" />
<File Id="File2File" Name="$(var.File2)" Vital="yes" KeyPath="yes" />
</Component>
</Directory>
</Directory>
<Feature Id="FeatureId" Title="New Files for a Feature" Level="1" >
<ComponentRef Id="File1"/>
<ComponentRef Id="File2"/>
</Feature>
</Product>
</Wix>

问题原因分析 #

当执行msiexec /a的**管理员安装（Administrative Install）**时，Windows Installer的行为和常规安装有本质区别：

1. 管理员安装的核心目的是创建管理映像（用于网络共享批量部署），而非将文件安装到目标系统的实际产品目录。
2. 若ENVVAR是用户级环境变量，管理员权限进程可能无法读取到该变量，导致[%ENVVAR]解析为空，最终PATHMAP默认继承TARGETDIR的路径（通常是系统自动选择的磁盘根目录，比如你的D:\）。
3. 即使ENVVAR是系统级变量，管理员安装模式下Windows Installer对环境变量的解析逻辑也与常规安装不同，容易导致路径计算异常。

解决方案 #

方案1：禁用管理员安装（推荐，符合你的使用场景） #

你的安装程序是用于更新已有产品的数据文件，管理员安装并不适配这个场景。可以在Wix代码中添加逻辑，阻止用户执行管理员安装：

<Product ...>
  <!-- 保留你原有的所有代码 -->

  <!-- 定义自定义错误提示动作 -->
  <CustomAction Id="BlockAdminInstall" Error="Administrative installation is not supported for this data update package. Please use regular installation (msiexec /i) instead." />

  <!-- 在安装初始化前检查是否为管理员安装，若是则触发错误 -->
  <InstallExecuteSequence>
    <Custom Action="BlockAdminInstall" Before="InstallInitialize">ADMININSTALL</Custom>
  </InstallExecuteSequence>

  <!-- 在UI序列中也添加检查，避免用户通过UI触发管理员安装 -->
  <InstallUISequence>
    <Custom Action="BlockAdminInstall" Before="WelcomeDlg">ADMININSTALL</Custom>
  </InstallUISequence>
</Product>

方案2：支持管理员安装（若确实需要） #

如果你必须支持管理员安装，需要调整路径逻辑，同时确保环境变量在管理员上下文可访问：

1. 将ENVVAR设为系统级环境变量：在系统属性中配置ENVVAR为系统环境变量，而非用户环境变量，确保管理员进程能读取到它。
2. 允许命令行覆盖路径：修改SetDirectory逻辑，当用户执行管理员安装时，可通过命令行参数指定PATHMAP：

<Product ...>
  <!-- 修改SetDirectory，仅当PATHMAP未被命令行指定时才使用环境变量 -->
  <SetDirectory Id="PATHMAP" Value="[%ENVVAR]\NewData" Sequence="first">NOT ADMININSTALL OR PATHMAP=""</SetDirectory>

  <!-- 保留你原有的其他代码 -->
</Product>

执行管理员安装时可手动指定路径：

msiexec /a filename.msi PATHMAP="C:\ProductPath\NewData" TARGETDIR="C:\AdminImage"

注：TARGETDIR是管理员安装的映像存储路径，PATHMAP是数据文件在映像中的相对路径（后续部署时会沿用这个路径）。

方案3：验证管理员上下文的环境变量 #

先确认执行msiexec /a的管理员进程是否能读取到ENVVAR：

1. 打开管理员命令提示符
2. 执行命令：echo %ENVVAR%
3. 如果输出为空，说明该环境变量未在管理员上下文配置，需要将其添加为系统环境变量。

补充说明 #

你组件中RemoveFile的清理旧文件逻辑是合理的，这个逻辑在常规安装下不受管理员安装问题的影响，无需调整。

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