Dotnet Build使用私有NuGet包报错NU1301：无法加载服务索引

实用排查与修复步骤 #

• 确认网络连通性
  用命令curl https://myprivate.privatenuget.org/F/privatepackages/api/v3/index.json或直接在浏览器打开该URL，验证是否能正常返回JSON内容。如果无法访问，排查本地防火墙、代理设置，或者私有仓库的网络访问权限配置。
• 核对NuGet配置细节
  除了全局NuGet.Config，还要检查项目根目录下的本地配置文件（如果存在），确保私有源的地址、名称无拼写错误：

  <packageSources>
    <add key="PrivateNuGet" value="https://myprivate.privatenuget.org/F/privatepackages/api/v3/index.json" />
  </packageSources>
  

  同时确认Azure AAD凭据配置正确，示例如下：

  <packageSourceCredentials>
    <PrivateNuGet>
      <add key="Username" value="AzureAD" />
      <add key="ClearTextPassword" value="[你的AAD访问令牌]" />
    </PrivateNuGet>
  </packageSources>
  

• 重新获取有效AAD令牌
  安装Azure CLI后执行以下命令更新源凭据：

  dotnet nuget update source PrivateNuGet --username AzureAD --password $(az account get-access-token --resource https://api.nuget.org/v3/index.json --query accessToken -o tsv)
  

  或者在Visual Studio中通过工具 > NuGet包管理器 > 包源设置，选中私有源后点击"更新凭据"重新完成AAD登录。
• 清理NuGet缓存
  执行命令dotnet nuget locals all --clear清空所有NuGet本地缓存，重启Visual Studio后再次尝试还原操作。
• 检查Visual Studio NuGet相关设置
  进入工具 > 选项 > NuGet包管理器 > 常规，确认"允许NuGet下载缺失的包"已勾选；切换到代理设置标签，检查是否配置了错误的代理导致无法访问私有源。
• 查看详细还原日志定位问题
  执行dotnet restore -v detailed，从生成的详细日志中查找私有源加载失败的具体原因（如证书验证失败、认证令牌过期、网络超时等），针对性解决。

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