Visual Studio 2017安装器安装AspNetDiagnosticPack.msi失败（错误1603）

我之前帮不少开发者搞定过VS2017安装组件时弹出1603错误的情况，针对你遇到的AspNetDiagnosticPack.msi安装失败、甚至连VS安装器都没法添加/移除组件的问题，可以按下面的步骤逐一排查：

第一步：清理MSI缓存与VS临时文件 #

• 以管理员身份打开命令提示符，先停止Windows Installer服务：

  net stop msiexec
  

• 导航到问题中的MSI所在目录，删除该安装包：

  cd C:\ProgramData\Microsoft\VisualStudio\Packages\Microsoft.VisualStudio.AspNetDiagnosticPack.Msi,version=15.0.40314.0
  del AspNetDiagnosticPack.msi
  

• 接着删除VS安装的缓存目录（如果不知道对应GUID，可以去%temp%目录下找以dd_vs_开头的日志文件，里面会记录相关信息）：

  rmdir /s /q C:\ProgramData\Package Cache\{对应GUID}
  

• 最后重启Windows Installer服务：

  net start msiexec
  

第二步：修复VS2017基础安装 #

• 先关掉所有VS相关的进程，包括VS安装器、devenv.exe等
• 打开VS安装器，找到你的VS2017 Professional实例，点击修复按钮
• 等待修复完成后，再尝试添加或移除组件

第三步：手动运行MSI生成详细日志定位问题 #

• 还是以管理员身份打开命令提示符，执行下面的命令生成安装日志：

  msiexec /i "C:\ProgramData\Microsoft\VisualStudio\Packages\Microsoft.VisualStudio.AspNetDiagnosticPack.Msi,version=15.0.40314.0\AspNetDiagnosticPack.msi" /l*v "C:\AspNetDiagnosticPack_install.log"
  

• 打开生成的AspNetDiagnosticPack_install.log文件，重点找Return value 3附近的内容，这里会明确写出安装失败的具体原因——比如权限不够、依赖组件缺失、系统文件损坏等

第四步：检查系统权限与依赖组件 #

• 确保当前登录的用户拥有本地管理员权限，权限不足是1603错误的常见原因之一
• 检查.NET Framework 4.x是否完整，你可以在命令提示符里执行dotnet --version查看版本，如果存在损坏，用官方的.NET Framework修复工具修复一下
• 把Windows的所有更新都安装完毕，有些系统补丁会影响VS组件的正常安装

第五步：重置VS安装器 #

• 以管理员身份执行下面的命令重置VS安装器：

  "C:\Program Files (x86)\Microsoft Visual Studio\Installer\resources\app\layout\Installer.exe" --repair
  

• 重置完成后，重新打开VS安装器再尝试操作

如果以上所有步骤都没能解决问题，建议你先备份好VS的设置和项目文件，然后完全卸载VS2017，清理掉所有相关残留目录（比如C:\Program Files (x86)\Microsoft Visual Studio、C:\ProgramData\Microsoft\VisualStudio等），最后重新下载安装包进行全新安装。

内容的提问来源于stack exchange，提问作者Vojtěch Dohnal