Azure DevOps构建管道CopyFiles任务报错：未找到SourceFolder

核心问题分析 #

报错##[error]Unhandled: Not found SourceFolder:的直接原因是CopyFiles任务指定的SourceFolder路径不存在，主要由以下几点导致：

• 硬编码了特定Agent和构建ID的绝对路径（如vsts-agent-1\_work\626\s），这类路径是动态变化的，无法在不同构建/Agent上复用
• 未验证ExtractFiles解压后的实际目录结构，导致路径猜测错误
• 冗余的Publish/Download步骤增加了路径出错的概率

排查与修复步骤 #

1. 验证解压后的实际目录结构 #

在ExtractFiles任务后添加PowerShell任务，列出解压目录的完整结构，确认PackageTmp的真实路径：

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      Get-ChildItem -Path "$(build.artifactstagingdirectory)\TestSite" -Recurse

运行构建后查看该任务的日志，找到PackageTmp的准确路径。

2. 替换硬编码的SourceFolder路径 #

根据第一步得到的真实路径，修改CopyFiles任务的SourceFolder，避免使用硬编码的Agent/构建ID路径。例如，如果实际路径是$(build.artifactstagingdirectory)\TestSite\Webapp\obj\Release\Package\PackageTmp，则修改为：

- task: CopyFiles@2
  inputs:
    SourceFolder: '$(build.artifactstagingdirectory)\TestSite\Webapp\obj\Release\Package\PackageTmp'
    Contents: '**'
    TargetFolder: '$(build.artifactstagingdirectory)\DeployedAPP'
    CleanTargetFolder: true
    OverWrite: true

3. 优化冗余的Publish/Download步骤 #

当前流程中先发布制品再下载解压是冗余操作，VSBuild已经将包直接生成在$(build.artifactStagingDirectory)下，可以直接解压该目录下的包，减少路径出错风险：
去掉PublishBuildArtifacts@1和DownloadBuildArtifacts@0任务，修改ExtractFiles@1的路径：

- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '$(build.artifactstagingdirectory)\Webapp.zip'
    destinationFolder: '$(build.artifactstagingdirectory)\TestSite'
    cleanDestinationFolder: true
    overwriteExistingFiles: true

4. 修复MSBuild参数的转义问题 #

VSBuild任务中PackageLocation的"可以替换为单引号，避免转义错误：

msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation=''$(build.artifactStagingDirectory)'''

修改后的完整YAML示例 #

trigger:
- main

pool:
  name: Default

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@0

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation=''$(build.artifactStagingDirectory)'''
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'
    clean: true

- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '$(build.artifactstagingdirectory)\Webapp.zip'
    destinationFolder: '$(build.artifactstagingdirectory)\TestSite'
    cleanDestinationFolder: true
    overwriteExistingFiles: true

- task: PowerShell@2
  inputs:
    targetType: 'inline'
    script: |
      Get-ChildItem -Path "$(build.artifactstagingdirectory)\TestSite" -Recurse

- task: CopyFiles@2
  inputs:
    SourceFolder: '$(build.artifactstagingdirectory)\TestSite\Webapp\obj\Release\Package\PackageTmp' # 替换为实际验证后的路径
    Contents: '**'
    TargetFolder: '$(build.artifactstagingdirectory)\DeployedAPP'
    CleanTargetFolder: true
    OverWrite: true

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