今日所有Azure DevOps托管.NET构建的DotNetCoreCLI@2还原任务失败

可能的原因与修复步骤 #

1. 检查nuget.config的源与网络配置 #

托管代理的网络环境可能无法正常访问nuget.config中配置的源，或是源配置存在异常：

• 确认配置中所有源地址（尤其是私有源）允许Azure DevOps托管代理的IP段访问
• 移除配置中冗余、无效的源条目，避免不必要的网络请求冲突
• 添加临时脚本任务，在托管代理上手动执行dotnet restore --configfile nuget.config，捕捉隐藏的认证或网络错误信息

2. 拆分项目还原任务 #

当前任务同时还原构建项目与测试项目，可能存在依赖冲突：

• 将原任务拆分为两个独立的DotNetCoreCLI@2任务，分别处理两类项目：

task: DotNetCoreCLI@2
displayName: Restore Build Projects
inputs:
  command: restore
  projects: '$(BuildParameters.RestoreBuildProjects)'
  selectOrConfig: config
  nugetConfigPath: nuget.config

task: DotNetCoreCLI@2
displayName: Restore Test Projects
inputs:
  command: restore
  projects: '$(BuildParameters.TestProjects)'
  selectOrConfig: config
  nugetConfigPath: nuget.config

3. 清理托管代理的NuGet缓存 #

托管代理的本地NuGet缓存可能已损坏：

• 在还原任务前添加脚本任务，执行缓存清理命令：

dotnet nuget locals all --clear

Windows托管代理可改用PowerShell执行相同命令。

4. 指定匹配的.NET SDK版本 #

托管代理默认SDK版本可能与项目不兼容，导致还原任务异常：

• 在还原任务前添加UseDotNet@2任务，指定项目所需的SDK版本：

task: UseDotNet@2
displayName: Use Target .NET SDK
inputs:
  packageType: sdk
  version: [你的项目SDK版本，如6.x/7.x]
  installationPath: $(Agent.ToolsDirectory)/dotnet

5. 排查项目文件中的无效依赖 #

部分项目可能存在无效的包引用或项目引用：

• 遍历所有项目文件，确认PackageReference和ProjectReference指向有效资源
• 本地删除obj、bin目录后重新还原，验证无问题再推送至仓库测试

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