通过

排查 SQL Server Management Studio 的安装和升级问题

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse Analytics

本故障排除指南提供解决 SQL Server Management Studio (SSMS) 安装和升级常见问题的分步说明。

联机安装或更新

请按顺序尝试以下适用于典型在线安装问题的可能解决方案。

1. 检查问题是否为已知问题

首先检查你遇到的问题是否是 Visual Studio 安装程序的已知问题（Microsoft 正在修复）。

若要查看问题是否有解决方法，请检查 SQL Server Management Studio 中的已知问题。

2.尝试修复 SSMS

尝试修复安装。 它可能会修复许多常见的更新问题。

3.删除安装程序文件夹（更新问题）

如果你在更新时遇到问题，请尝试删除 Visual Studio 安装程序文件夹，然后重新运行安装启动加载程序。 执行此操作将重新安装 Visual Studio 安装程序文件并重置安装元数据。

  1. 关闭 Visual Studio 安装程序。

  2. 删除 Visual Studio 安装程序文件夹。 文件夹路径通常为 C:\Program Files (x86)\Microsoft Visual Studio\Installer。

  3. 运行 SSMS 启动加载程序。 可以在“下载”文件夹中找到文件名为 的启动加载程序vs_SSMS.exe。 或者，可以从 SSMS 的安装页下载启动加载程序。 然后，运行此可执行文件，重置安装元数据。

  4. 尝试再次安装或更新 SSMS。 如果安装程序继续失败，请向支持人员报告问题。

4.向支持人员报告问题

在某些情况下，如果存在损坏的文件，问题可能需要逐个排查。

按照以下步骤将问题提交到 Microsoft 支持：

  1. 收集安装日志。 有关详细信息，请参阅收集安装日志以提供给 Microsoft 支持。

  2. 打开 Visual Studio 安装程序，然后选择“报告问题”打开反馈工具。

  3. 此步骤将打开开发者社区网站，并要求你登录。

  4. 为问题报告提供标题，并提供相关的详细信息。 请参阅收集安装日志以提供给 Microsoft 支持，以捕获 Visual Studio 安装程序的安装日志，并将其作为附件添加到问题报告。

  5. 选择“提交”。

5.删除所有 SSMS 安装文件

作为最后的手段，可以删除所有 SSMS 安装文件和产品信息：

  1. 使用 InstallCleanup.exe 删除所有内容。

  2. 重新运行 SSMS 启动加载程序。 可以在“下载”文件夹中找到文件名为 vs_SSMS.exe 的启动加载程序。 或者，可以从安装页面下载引导程序。

  3. 尝试重新安装 SSMS。

网络布局或脱机安装

若要解决网络安装问题，请参阅错误代码或排查在安装或使用 Visual Studio 时出现的网络相关错误。

为 Microsoft 支持部门收集安装日志

如果你联系 Microsoft 支持部门，可能会被要求使用 Microsoft Visual Studio 和 .NET Framework 日志收集工具收集安装日志。 日志收集工具从 SSMS 和 Visual Studio 安装的所有组件（包括 .NET Framework）收集安装日志。 此收集工具还会收集 Visual Studio 安装程序、Windows Installer 和系统还原的计算机信息、Windows Installer 清单和 Windows 事件日志信息。

若要收集日志，请执行以下步骤：

  1. 从 https://aka.ms/vscollect. 下载该工具。

  2. 打开管理命令提示符。

  3. 在保存工具的文件夹中运行 collect.exe。

工具必须在安装失败时使用的同一用户帐户下运行。 若要从其他用户帐户运行工具，请设置 -user:<name> 选项，以指定运行失败安装的用户帐户。 从管理员命令提示符运行 collect.exe -? 以获取更多选项和使用情况信息。

该工具会在 vslogs.zip 文件夹中生成 %TEMP% 文件，该文件的路径通常为 C:\Users\YourName\AppData\Local\Temp\vslogs.zip。

使用 Visual Studio 安装程序和 SSMS IDE 中显示的报告问题工具向我们报告产品问题。