WiX Toolset升级修改安装范围时出现‘写入文件错误’

问题描述 #

使用WiX Toolset 4升级应用安装程序：旧版本未指定安装范围，新版本设置为perUser以支持非管理员用户安装。执行升级时出现以下错误：

"Error writing to file filename.exe. Verify that you have access to the directory."

新旧版本均安装在AppData下同一目录，且已配置<MajorUpgrade>元素确保先卸载旧版本再安装新版本，但问题仍未解决。

排查与解决思路 #

• 确认旧版本实际安装范围：旧版本未显式指定范围时，Windows Installer可能默认按perMachine安装（若用户当初以管理员权限执行安装）。即便安装路径在AppData，perMachine模式下的文件权限、注册表项与perUser模式存在差异，可能导致卸载不彻底或权限遗留。可通过查看注册表HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\[旧版本ProductCode]或HKEY_CURRENT_USER下对应路径的InstallLocation、SystemComponent值确认旧版本安装范围。
• 校验<MajorUpgrade>执行逻辑：确保<MajorUpgrade>的Schedule属性设置为afterInstallInitialize（默认值），同时检查MSI日志中旧版本卸载步骤的返回码，确认旧版本是否被完全卸载。若旧版本为perMachine模式，新版本perUser模式的升级可能因权限上下文不一致，导致卸载残留。
• 排查文件锁与残留进程：升级过程中旧版本的filename.exe可能仍在后台运行，导致文件被锁定无法写入。可在MSI日志中查找FileInUse相关条目，或通过WiX添加<CustomAction>调用taskkill命令，在升级前强制关闭目标进程。
• 显式配置目录权限：旧版本perMachine模式安装的AppData目录可能带有特殊权限，新版本perUser模式无法继承正确的写入权限。可在WiX中为目标目录添加<Permission>元素，显式授予当前用户FullControl权限。
• 调整升级执行顺序：将<MajorUpgrade>的Schedule属性改为afterInstallExecute，先完成新版本文件写入，再卸载旧版本。此方式可避开权限冲突，但需注意文件覆盖的兼容性问题。
• 深挖MSI日志细节：定位日志中写入失败的具体步骤，对照Windows Installer错误码（如1603通常关联权限或文件冲突）分析根因，重点关注旧版本卸载完成后到新版本安装前的文件系统状态变化。

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