Azure App Service zipDeploy未删旧文件，部署空Zip出错求助

失败原因 #

1. 异步操作竞态冲突：AzureRmWebAppDeployment@4的空Zip部署、清理脚本、实际包部署环节中，Azure App Service的文件系统操作是异步执行的，任务本身不会等待前一步的文件删除/覆盖操作完全完成就启动下一步，导致后续操作访问被占用的文件或目录，触发“目录非空”“文件访问被拒”错误。
2. .NET 6+文件锁定机制变化：.NET 6+默认采用独立部署模式，运行时会锁定wwwroot目录下的核心程序集文件，导致原有自动清理旧文件的逻辑失效，同时也会阻碍手动清理或覆盖操作。
3. 空Zip部署逻辑限制：空Zip部署试图通过覆盖方式清空wwwroot，但如果目录内存在被进程锁定的文件，部署任务会直接报错“目录非空”，无法完成清理。

替代清理方案 #

方案1：使用zipDeploy官方清理参数（推荐） #

直接在AzureRmWebAppDeployment@4任务中添加--delete-existing-files参数，无需额外空Zip步骤，部署时自动删除旧文件：

- task: AzureRmWebAppDeployment@4
  inputs:
    ConnectionType: 'AzureRM'
    azureSubscription: '<你的Azure订阅>'
    appType: 'webApp'
    WebAppName: '<你的App Service名称>'
    packageForLinux: '<你的代码包路径>'
    AdditionalArguments: '--delete-existing-files'

注意：若仍出现文件锁定问题，可配合添加停止/启动站点的步骤，确保部署时无进程占用文件。

方案2：先停止站点再清理部署 #

通过Azure CLI任务先停止App Service进程，彻底清理wwwroot后再部署，避免文件锁定：

1. 停止站点：

az webapp stop --name <App Service名称> --resource-group <资源组名称>

2. 清理wwwroot目录（根据操作系统选择）：
   • Linux环境：

   az webapp exec --name <App Service名称> --resource-group <资源组名称> --command "rm -rf /home/site/wwwroot/*"
   

   • Windows环境：

   az webapp exec --name <App Service名称> --resource-group <资源组名称> --command "Remove-Item C:\home\site\wwwroot\* -Recurse -Force"
   

3. 启动站点：

az webapp start --name <App Service名称> --resource-group <资源组名称>

4. 执行AzureRmWebAppDeployment@4部署实际代码包

方案3：部署插槽交换（无停机部署） #

利用Azure App Service的部署插槽功能，在staging插槽完成清理和部署后，原子性交换到生产环境，避免生产环境的文件锁定问题：

1. 部署到staging插槽时，添加--delete-existing-files参数清理旧文件
2. 执行插槽交换：

az webapp deployment slot swap --name <App Service名称> --resource-group <资源组名称> --slot staging --target-slot production

解决原有方案的竞态条件问题 #

如果坚持使用空Zip+清理的方案，需在任务之间添加等待逻辑，确保前一步操作完全完成：
添加一个循环等待的脚本任务，检查wwwroot目录是否为空，直到清理完成再继续：

• Linux环境示例：

while true; do
  FILE_COUNT=$(az webapp exec --name <App Service名称> --resource-group <资源组名称> --command "ls -la /home/site/wwwroot | wc -l")
  if [ $FILE_COUNT -le 2 ]; then # 保留.和..两个默认目录
    break
  fi
  echo "等待wwwroot目录清理完成，当前文件数：$FILE_COUNT"
  sleep 10
done

• Windows环境示例：

while ($true) {
  $fileCount = (az webapp exec --name <App Service名称> --resource-group <资源组名称> --command "(Get-ChildItem C:\home\site\wwwroot).Count")
  if ($fileCount -eq 0) {
    break
  }
  Write-Host "等待wwwroot目录清理完成，当前文件数：$fileCount"
  Start-Sleep -Seconds 10
}

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