Azure DevOps Pipeline NuGet还原失败：未使用包Portable.BouncyCastle下载报错

可能的原因及排查方案 #

1. 间接依赖触发下载 #

你没有直接引用这个包，但项目中已安装的某个包依赖了Portable.BouncyCastle.1.8.5，这是最常见的触发原因。

• 排查方式：
  • 本地执行命令：dotnet list <你的项目路径/项目文件.csproj> package --include-transitive，查看所有间接依赖，定位到依赖该包的上层包。
  • 用Visual Studio打开项目，在NuGet包管理器中右键已安装的包，选择「查看依赖项」，逐层排查依赖链。

2. 缓存或残留配置干扰 #

流水线代理或项目残留的旧缓存、无效配置，可能导致NuGet错误地尝试下载该包：

• 解决方法：
  在流水线中添加缓存清理步骤，修改后的配置如下：

  steps:
  - script: 'nuget locals all -clear'
    displayName: 'Clear NuGet local caches'
  - task: NuGetCommand@2
    displayName: 'NuGet restore'
    inputs:
      restoreSolution: '$(Parameters.solution)'
      arguments: '--no-cache'
  

  同时本地开发环境可手动删除项目的obj、bin、packages文件夹，重新生成解决方案后再提交代码。

3. 包版本或源有效性问题 #

• 先手动访问报错中的URL：https://api.nuget.org/v3-flatcontainer/portable.bouncycastle/1.8.5/portable.bouncycastle.1.8.5.nupkg，确认该版本包是否仍在官方源存在。如果无法访问或包已被移除：
  • 升级依赖该包的上层包到最新版本，通常新版本会适配更稳定的Portable.BouncyCastle版本。
  • 若必须使用该版本，检查是否有其他NuGet源可提供该包，并在流水线中添加对应源配置。

4. 解决方案或项目文件残留引用 #

检查你的.sln文件是否包含已废弃的项目，或者项目的.csproj/packages.config（旧项目）中是否存在隐藏的Portable.BouncyCastle.1.8.5引用，清理这些无效配置后重新执行还原。

关于流水线配置的说明 #

你当前的NuGetCommand@2配置本身没有问题，默认会使用NuGet官方源执行还原。但遇到缓存、依赖解析异常时，需添加清理缓存、指定源等额外参数来规避问题。

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