如何重现/注入MSI安装错误？基于WIX实现Return value 3的安装失败

当然有办法！下面几种方案可以帮你在WIX开发的MSI安装程序里触发1xxx/2xxx类错误码，同时让安装日志里明确显示Return value 3：

方法1：自定义动作主动抛出错误 #

这是最灵活可控的方式——直接写一个自定义动作，让它返回指定的1xxx/2xxx错误码，强制MSI终止安装。

比如用VBScript写个极简的失败动作：

Function ForceInstallFail()
    ' 返回1603（通用安装失败，属于1xxx类），你也可以换成2303、2711这类2xxx错误码
    ForceInstallFail = 1603
End Function

然后在WIX里注册这个动作，把它插入到安装序列的关键位置（比如初始化之后）：

<CustomAction Id="ForceFailAction" Script="vbscript" VBScriptCall="ForceInstallFail" />
<InstallExecuteSequence>
    <Custom Action="ForceFailAction" After="InstallInitialize" />
</InstallExecuteSequence>

安装时这个动作执行失败，MSI日志里就会出现Return value 3，同时抛出你指定的错误码。

方法2：故意制造依赖缺失 #

让安装程序依赖一个不存在的系统资源或文件，触发MSI内置的错误机制：
比如添加一个指向不存在文件的组件：

<Component Id="MissingDependency" Guid="YOUR-GUID-HERE">
    <File Id="MissingFile" Source="C:\This\Path\Does\Not\Exist.dll" KeyPath="yes" />
</Component>

当MSI尝试复制这个不存在的文件时，会触发2303错误（文件读取失败，属于2xxx类），安装终止，日志里同样会记录Return value 3。

方法3：模拟权限不足场景 #

如果你的安装程序需要管理员权限，用普通用户身份运行安装包，或者修改自定义动作的执行权限为当前用户，然后尝试写入受保护目录：

<CustomAction Id="WriteToProtectedDir" Script="vbscript" Impersonate="yes">
    Dim fso
    Set fso = CreateObject("Scripting.FileSystemObject")
    ' 尝试写入系统保护目录，普通用户无权限
    fso.CreateTextFile("C:\Windows\System32\TestFail.txt", True)
</CustomAction>
<InstallExecuteSequence>
    <Custom Action="WriteToProtectedDir" After="InstallFiles" />
</InstallExecuteSequence>

这个动作会因权限不足失败，触发1603错误，日志里显示Return value 3。

关键提示 #

Return value 3本质是MSI用来标记“某个关键操作执行失败，安装终止并回滚”的日志信息——只要让任何安装序列中的必要步骤失败，都会触发它。1xxx/2xxx错误码都是MSI标准错误，你可以根据需要选择对应场景（比如1603是通用失败，2711是指定组件不存在）。

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