Azure DevOps Pipeline中YAML还原本地源NuGet包异常求助

1. 验证Feed权限与ID正确性 #

• 确认流水线使用的构建服务账号（如[项目名]构建服务([组织名])）拥有目标Azure Artifacts Feed的读取权限：进入Feed的“权限”页面，检查该账号是否在“贡献者”或“读者”列表中。经典UI流水线可能默认继承了项目权限，YAML流水线可能因权限变更（如最近调整过Feed权限）失去访问权。
• 核对vstsFeed的两段GUID是否正确：第一段是项目ID，第二段是Feed ID。可以从Azure Artifacts Feed的“连接到Feed”页面获取正确的ID组合，确保与YAML中配置一致（即使是从经典UI导出，也可能存在ID匹配错误）。

2. 检查托管代理环境差异 #

• 托管代理镜像可能在周末更新，导致dotnet/NuGet环境变化。在YAML中添加步骤打印环境信息，与经典UI流水线的运行日志对比：

  - task: DotNetCoreCLI@2
    displayName: 查看dotnet环境信息
    inputs:
      command: custom
      custom: --info
  - task: CmdLine@2
    displayName: 列出NuGet源
    inputs:
      script: nuget sources list
  

• 重点确认：dotnet版本是否与经典UI一致，NuGet源列表中是否包含目标Azure Artifacts源，源的URL是否有效。

3. 绕开vstsFeed参数验证身份 #

• 尝试使用NuGetAuthenticate任务手动注入凭据，再执行restore，排除vstsFeed参数的潜在问题：

  - task: NuGetAuthenticate@1
    displayName: NuGet身份验证
  - task: DotNetCoreCLI@2
    displayName: dotnet restore
    inputs:
      command: restore
      projects: '**\*.sln'
      feedsToUse: config
      # 如果有自定义nuget.config，指定路径；无则省略，使用默认配置
      nugetConfigPath: nuget.config
  

• 或者直接在restore命令中指定完整源URL：

  - task: DotNetCoreCLI@2
    displayName: dotnet restore
    inputs:
      command: restore
      projects: '**\*.sln'
      arguments: '--source https://pkgs.dev.azure.com/[你的组织]/[你的项目]/_packaging/[Feed名称]/nuget/v3/index.json'
  

4. 检查流水线级权限设置 #

• 进入YAML流水线编辑页面，点击右上角... -> 管道权限，确认是否授予了流水线访问Azure Artifacts的权限。若启用了“限制授权范围”，需确保目标Feed被包含在授权范围内。

5. 排除缓存或网络问题 #

• 强制跳过缓存执行restore，避免代理缓存导致的异常：

  - task: DotNetCoreCLI@2
    displayName: dotnet restore（无缓存）
    inputs:
      command: restore
      projects: '**\*.sln'
      vstsFeed: "afcdef6a-5c72-4a0e-90c5-33d9e751869c/ab1da1d1-3562-4a0a-9781-4f4d80de93ba"
      arguments: '--no-cache'
  

• 查看流水线日志的详细输出，添加arguments: '-v detailed'到restore任务，检查是否存在网络连接超时、DNS解析失败或401/403权限错误。

6. 对比经典UI与YAML的日志差异 #

• 开启经典UI流水线的详细日志，与YAML流水线的详细日志逐段对比，重点关注：
  • 凭据注入过程是否一致
  • NuGet源的加载顺序与URL是否相同
  • 构建服务账号的身份标识是否一致

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