AzureStaticWebApp@0任务上传新文件前如何清理全部旧文件

核心结论 #

• AzureStaticWebApp@0任务默认不会自动清理历史部署遗留的未使用文件，webpack构建生成的带hash JS分片多次部署后会持续堆积。
• 该任务原生没有提供「部署前删除整个目标文件夹」的配置项，无法仅通过修改该任务的输入参数实现全量清空，但可以通过组合流水线步骤实现需求。

具体实现方案 #

方案1：部署前全量清空存储账户静态内容容器（匹配直接删除整个目标文件夹的需求） #

Azure存储账户静态网站的默认托管容器为$web，可以在执行AzureStaticWebApp@0部署任务前，增加Azure CLI步骤清空容器内所有存量文件，再推送新版本代码，部署完成后存储内只会保留本次发布的文件，无任何历史冗余。
步骤配置参考，放在原有AzureStaticWebApp@0任务之前即可：

- task: AzureCLI@2
  inputs:
    azureSubscription: '你的Azure服务连接名称' # 与Static Web App部署任务使用同一个服务连接
    scriptType: 'bash' # Windows代理可替换为pscore
    scriptLocation: 'inlineScript'
    inlineScript: |
      # 替换为实际的存储账户名称
      az storage blob delete-batch \
        --account-name 替换为你的存储账户名 \
        --source '$web' \
        --auth-mode login

权限说明：需要给流水线使用的服务连接对应的服务主体分配目标存储账户的「存储Blob数据参与者」角色，否则删除操作会抛出权限错误。

方案2：定向清理指定类型的旧文件（保留固定静态资源） #

如果存储内存在不需要随部署更新的固定文件（如favicon、robots.txt、永久缓存的公共静态资源），不需要全量清空的，可以给删除命令加路径匹配规则，仅清理webpack生成的JS分片等冗余文件，示例：

inlineScript: |
  az storage blob delete-batch \
    --account-name 替换为你的存储账户名 \
    --source '$web' \
    --pattern 'assets/js/*.js' # 按实际webpack输出的分片路径调整匹配规则
    --auth-mode login

方案3：源头优化构建输出 #

可以在webpack配置中设置output.clean = true，保证本地构建生成的app/dist目录本身不存在旧构建产物，但该配置仅能保证待上传的源目录干净，无法清除存储端已经存在的历史冗余文件，需要配合上述清理步骤才能彻底解决存量堆积问题。

现有配置调整说明 #

你当前使用的AzureStaticWebApp@0任务配置不需要做任何修改，只要按顺序调整流水线步骤即可：

1. 代码拉取、项目构建步骤（当前配置开启了skip_app_build: true，需保证前置构建输出的app/dist目录内容正确）
2. Azure CLI清理存储旧文件步骤
3. 原有AzureStaticWebApp@0部署步骤

当前使用的任务配置参考：

- task: AzureStaticWebApp@0
          inputs:
            app_location: 'app/dist'
            api_location: 'api'
            output_location: 'dist'
            skip_app_build: true

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