Angular应用Azure DevOps部署报错：找不到指定ZIP包

问题根源 #

• 硬编码绝对路径不可靠：Deployment作业的工作区路径会随代理环境、作业编号变化（比如不一定是/home/vsts/work/1），直接写死路径极易导致文件查找失败。
• 变量引用或传递异常：$(Build.BuildId)在部署阶段可能未正确继承构建阶段的数值，导致路径拼接错误。
• 默认搜索路径不匹配：AzureWebApp@1任务默认会在当前工作目录（Deployment作业中为/home/vsts/work/1/s）下搜索**/*.zip，但构建产物被下载到了其他目录，因此触发找不到包的报错。

修复方案 #

方案1：使用管道变量指定可靠路径 #

放弃硬编码路径，改用$(Pipeline.Workspace)变量指向artifact下载目录，这是Azure DevOps推荐的标准用法：

- task: AzureWebApp@1
  displayName: 'Deploy to Development'
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(webAppName)
    packageForLinux: '$(Pipeline.Workspace)/drop/$(Build.BuildId).zip'
    deploymentMethod: 'zipDeploy'              
    startUpCommand: 'pm2 serve /home/site/wwwroot/dist/vms-project-web --spa --no-daemon'

如果仍报错，先查看调试脚本ls -R $(Pipeline.Workspace)的输出，确认ZIP包文件名是否与$(Build.BuildId).zip完全一致。

方案2：用通配符简化路径引用 #

修改DownloadPipelineArtifact的下载路径，让ZIP包直接存放在$(Pipeline.Workspace)根目录，再用通配符自动匹配文件：

- task: DownloadPipelineArtifact@2
  displayName: 'Download Build Artifacts'
  inputs:
    artifactName: 'drop'
    downloadPath: '$(Pipeline.Workspace)'

- task: AzureWebApp@1
  displayName: 'Deploy to Development'
  inputs:
    azureSubscription: $(azureSubscription)
    appName: $(webAppName)
    packageForLinux: '$(Pipeline.Workspace)/**/*.zip'
    deploymentMethod: 'zipDeploy'              
    startUpCommand: 'pm2 serve /home/site/wwwroot/dist/vms-project-web --spa --no-daemon'

通配符**/*.zip会递归搜索目标目录下的所有ZIP文件，规避文件名或变量传递的潜在问题。

方案3：验证构建阶段的Artifact生成流程 #

确认构建阶段的打包和发布步骤无错误：

• ArchiveFiles任务的archiveFile配置$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip是正确的，$(Build.ArtifactStagingDirectory)是Azure DevOps构建作业的标准临时存储目录。
• Publish步骤的artifact名称drop与部署阶段下载的名称完全一致，无拼写错误。

额外调试建议 #

在部署阶段添加脚本，打印关键变量值和文件列表，快速定位问题：

- script: |
    echo "当前Build.BuildId值：$(Build.BuildId)"
    echo "Pipeline.Workspace绝对路径：$(realpath $(Pipeline.Workspace))"
    ls -la $(Pipeline.Workspace)/drop
  displayName: 'Debug: 验证变量与文件'

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