离线Azure DevOps服务器运行Pipeline构建找不到NuGet包如何解决

1. 验证NuGet.config配置正确性 #

NuGet.config必须放在解决方案根目录（与.sln文件同级），且需要先清空默认的公网源配置，避免构建时优先请求无法访问的公网地址，正确配置示例如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!-- 先清空所有默认源，避免请求公网 -->
    <clear />
    <add key="LocalOfflineSource" value="./.packages" />
  </packageSources>
</configuration>

2. 调整Azure DevOps构建任务配置 #

• 检查NuGet还原任务的配置：必须指定使用你提交到仓库的NuGet.config文件，不要使用DevOps服务器的全局配置。如果使用dotnet restore命令执行还原，需要添加参数明确指定配置文件路径：dotnet restore --configfile NuGet.config
• 确认.packages文件夹已提交到代码仓库：默认.gitignore规则通常会忽略packages类文件夹，导致构建代理拉取代码时根本没有拿到该目录，检查.gitignore规则，确认.packages文件夹没有被忽略，且已成功推送到DevOps代码仓库
• 避免相对路径识别异常：如果构建代理工作目录存在特殊字符/层级过深，可使用DevOps预定义变量拼接绝对路径执行还原，示例命令：
  dotnet restore --configfile $(Build.SourcesDirectory)/NuGet.config $(Build.SourcesDirectory)/你的解决方案名称.sln

3. 额外排查点 #

• 检查.packages文件夹下的包结构是否符合要求：NuGet本地源要求每个包的存储格式为.packages/[包名]/[版本号]/[包名].[版本号].nupkg，不要直接把nupkg文件放在.packages根目录，也不要修改文件夹命名规则
• 确认包版本完全匹配：检查.packages下存放的Azure.Core确实是1.20.0版本，无版本号拼写错误、大小写不一致问题
• 如果使用NuGet.exe而非dotnet命令执行还原，添加参数-ConfigFile NuGet.config指定配置文件即可

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