配置外部NuGet源后dotnet restore项目失败的解决求助

环境与问题背景 #

本地机器的nuget.config配置了多个NuGet源，其中externalSource指向外部受保护源（配置由Visual Studio生成）：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
    <packageSources>
        <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
        <add key="externalSource" value="https://.external_source./nuget/v3/index.json" />
        <add key="Microsoft Visual Studio Offline Packages" value="C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\" />
   </packageSources>
</configuration>

可通过浏览器输入凭据正常访问所有源的JSON配置，Visual Studio的NuGet管理器UI也能正常使用该外部源。

创建简单控制台应用：

PS C:\..> dotnet new console --no-restore
The template "Console App" was created successfully

（注：特意跳过restore以聚焦问题，否则dotnet new console命令会直接失败）

执行dotnet restore时触发401未授权错误：

PS C:\..> dotnet restore
  Determining projects to restore...
C:\Program Files\dotnet\sdk\8.0.100\NuGet.targets(156,5): error : Unable to load the service index for source "https://.external_source./nuget/v3/index.json". [C:\..\test.csproj]
C:\Program Files\dotnet\sdk\8.0.100\NuGet.targets(156,5): error :   Response status code does not indicate success: 401 (Unauthorized). [C:\..\test.csproj]

启用详细日志后，确认错误发生在RestoreTask阶段，核心问题是无法加载externalSource的服务索引，返回未授权。

已尝试的无效操作 #

• 在nuget.config中添加明文凭据配置，无效果：

  <packageSourceCredentials>    
     <externalSource>      
        <add key="Username" value="name" />      
        <add key="ClearTextPassword" value=".." />    
     </externalSource>  
  </packageSourceCredentials>
  

• 使用dotnet restore --interactive或dotnet restore --ignore-failed-sources参数，问题依旧。

注：使用dotnet restore --source=nuget.org可绕过问题，但需保留externalSource配置以满足其他场景需求。

关键更新信息 #

• 执行nuget search -take 10 -Source externalSource后，错误消失但30分钟后再次出现401。
• 问题仅出现在Windows 11 Enterprise系统，Windows 10下无此异常。
• 使用msbuild -t:Restore可正常完成还原，怀疑是dotnet CLI二进制文件的兼容性问题。

解决方案建议 #

1. 重新配置系统凭据存储
   避免在nuget.config中写明文密码，直接通过命令行将凭据存入Windows凭据管理器：

   nuget sources update -Name externalSource -UserName <你的用户名> -Password <你的密码>
   

   操作后检查凭据管理器（控制面板→用户账户→凭据管理器→Windows凭据）中是否存在对应NuGet源的凭据，再执行dotnet restore测试。

2. 验证dotnet CLI的生效配置
   用以下命令查看当前dotnet CLI加载的源和凭据配置，确认externalSource的凭据是否正确生效：

   dotnet nuget list source
   

   若存在多份nuget.config（项目根目录、用户目录、系统目录）冲突，可暂时重命名非必要的配置文件，仅保留项目根目录的配置测试。

3. 更新或更换dotnet SDK版本
   由于问题仅出现在Windows 11的SDK 8.0.100，尝试：

   • 升级到最新的8.0.x补丁版本（如8.0.200+），微软可能修复了Windows 11下的凭据读取bug；
   • 回退到8.0.100之前的稳定版本，或安装7.0系列SDK测试，确认是否为特定版本的兼容性问题。

4. 强制使用MSBuild的还原逻辑
   既然msbuild -t:Restore有效，可在项目的Directory.Build.props中添加配置，让dotnet CLI默认使用MSBuild的还原引擎：

   <PropertyGroup>
     <RestoreUseMSBuildEngine>true</RestoreUseMSBuildEngine>
   </PropertyGroup>
   

   保存后执行dotnet restore即可复用MSBuild的凭据读取逻辑。

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