多台机器安装自定义MSI时遇Error 2203错误：求排查方案

问题场景 #

使用以下命令部署自定义生成的MSI时触发错误：

msiexec /i localMSI.msi /qn /L*V localMSI.log 

弹出错误提示：

"安装程序在安装此软件包时遇到意外错误。这可能表明此软件包存在问题。错误代码为2203。"

排查发现：

• msiexec进程持续运行
• C:\Windows\Installer\inprogressinstallinfo.ipi 文件被锁定无法删除
• 手动终止msiexec进程后，安装可正常完成
• 该问题在多台机器上复现
• 注：此MSI由C#代码生成，用于跨机器部署

错误日志片段 #

MSI (s) (C0:94) [23:59:22:166]: Server not locked: locking for product {186ADC86-B01C-4320-8850-AF1EB2322259} 
MSI (s) (C0:94) [23:59:22:166]: Note: 1: 2203 2: C:\Windows\Installer\inprogressinstallinfo.ipi 3: -2147287008  
MSI (s) (C0:94) [23:59:22:166]: Note: 1: 2262 2: Error 3: -2147287038  
Action start 23:59:22: InstallInitialize. 
DEBUG: Error 2203: Database: C:\Windows\Installer\inprogressinstallinfo.ipi. Cannot open database file. System error -2147287008 
MSI (s) (C0:94) [23:59:22:182]: Note: 1: 2262 2: Error 3: -2147287038  
MSI (s) (C0:94) [23:59:22:182]: Product: localMSI -- The installer has encountered an unexpected error installing this package. This may indicate a problem with this package. The error code is 2203. The arguments are: C:\Windows\Installer\inprogressinstallinfo.ipi, -2147287008. 
The installer has encountered an unexpected error installing this package. This may indicate a problem with this package. The error code is 2203. The arguments are: C:\Windows\Installer\inprogressinstallinfo.ipi, -2147287008.  
Action ended 23:59:22: InstallInitialize. Return value 3. 
Action ended 23:59:22: INSTALL. Return value 3. 

已尝试操作 #

• 重新执行安装命令：msiexec /i DotNetInterfaceInstaller.msi /qn /L*V DotNetInterfaceReInstall.log
• 排查到msiexec进程锁定inprogressinstallinfo.ipi文件
• 手动终止msiexec进程后安装成功

预期结果 #

• MSI可无错误完成安装
• 作为团队部署用MSI，能在多台机器上平稳执行安装流程

根本原因分析 #

1. 安装残留锁：之前的MSI安装进程异常终止（如强制关闭、系统重启中断），导致msiexec服务未正确释放inprogressinstallinfo.ipi文件的锁定，该文件用于跟踪正在进行的安装任务，锁残留会阻止新安装启动。
2. 自定义MSI生成缺陷：C#代码生成MSI时，未正确处理安装序列的清理逻辑，比如安装失败时未触发完整回滚流程，导致锁文件未被正常删除。
3. 权限冲突：安装进程对C:\Windows\Installer目录的权限不足，无法正常读写锁文件，导致进程挂起并持续占用文件。

长效解决办法 #

1. 预安装自动清理残留锁 #

在安装脚本中加入前置检查，自动终止残留进程并清理锁文件（需管理员权限运行）：

@echo off
:: 终止所有msiexec进程
taskkill /f /im msiexec.exe >nul 2>&1
:: 删除锁定的ipi文件
del /f /q "C:\Windows\Installer\inprogressinstallinfo.ipi" >nul 2>&1
:: 执行MSI安装
msiexec /i localMSI.msi /qn /L*V localMSI.log

2. 修复自定义MSI生成逻辑 #

针对C#生成MSI的代码，需确保：

• 安装序列包含完整回滚逻辑，安装失败时自动清理临时文件和锁资源
• 正确设置MSI的InstallerCleanup属性，确保异常终止后自动释放资源
• 避免在安装过程中调用会导致进程挂起的外部程序，防止msiexec无法正常退出

3. 优化安装权限配置 #

• 在MSI属性中设置RunAsAdministrator，确保安装包以管理员权限运行
• 必要时给C:\Windows\Installer目录添加当前用户的读写权限（谨慎调整，避免过度开放权限）

4. 配置MSI服务自动恢复 #

1. 打开服务管理器，找到Windows Installer服务
2. 右键选择「属性」→「恢复」
3. 设置「第一次失败」「第二次失败」「后续失败」为「重新启动服务」
4. 保存设置，确保服务异常后自动重启释放锁资源

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