排除安装 .NET.NET Aspire 工作负载的问题

本文提供指导,帮助您排查在从 .NET CLI 安装 .NET Aspire 工作负载时可能遇到的问题。

症状

安装 .NET.NET Aspire 工作负荷时,可能会遇到安装错误。 错误消息可能指示安装失败,或者无法安装工作负荷。 错误消息还可能指示包源不可用,或者找不到包源通常类似于:

Workload update failed: One or more errors ocurred: (Version X.Y.00Z of package A.B.C is not found in NuGet feeds.

一个常见的问题是,在尝试运行 dotnet 工作负载命令时,您的 SDK 已经识别出某些在配置的源中不存在的工作负荷清单或工作负荷包版本。 如果 SDK 在每日检查更新期间,在源中查找未在运行 dotnet workload 命令时使用的工作负载清单的新版本,则可能会发生这种情况。 这种差异可能会导致安装过程中出现错误。

即使使用正确的源,一个不太常见的问题是,工作负荷清单可能依赖于未在同一源上发布的工作负荷包。 这也可能导致安装过程中出现错误,因为找不到所需的包。

可能的解决方案

确保将任何递归 Nuget.config 文件配置为指定正确的包源和 NuGet 源。 例如,如果用户配置文件目录中有 Nuget.config 文件,请确保它未指定不再可用的包源。

如果您遇到与 SDK 识别出配置的数据源中不存在的工作负荷清单或工作负荷包版本相关的错误,可能需要调整数据源或查找包含新版本清单或所需包的数据源。

如果工作负载清单依赖于未在同一源上发布的工作负载包,则需要查找并将该包所在的位置添加到 NuGet 配置中。

重要

某些开发环境可能依赖于提供较新版工作负荷清单或工作负荷包的私有源。 在这些情况下,你可能想要禁用每日 SDK 检查更新,以避免在安装过程中遇到错误。

若要禁用每日 SDK 检查更新,请将 DOTNET_CLI_WORKLOAD_UPDATE_NOTIFY_DISABLE 环境变量设置为 true

另请参阅