Azure Static Web Apps staging environments数量达上限致GitHub workflow中pull-request构建失败，如何清理多余环境？

这个错误是因为你的Azure Static Web Apps实例已经达到了允许的最大staging环境数量——免费层最多3个，标准层最多10个。下面是几种清理和预防的方法：

方法1：通过Azure门户手动删除 #

这是最直观的方式，适合快速清理个别环境：

• 登录Azure门户，找到你的Static Web App资源
• 在左侧导航栏里找到Environments（环境）选项
• 你会看到所有的staging环境列表，每个环境对应一个PR分支（命名格式一般是pr-<PR编号>或者自定义的分支名）
• 选中你不再需要的环境，点击顶部的Delete（删除）按钮，确认操作即可

方法2：使用Azure CLI批量/精准删除 #

如果需要批量清理或者自动化操作，CLI是更好的选择：

1. 首先登录Azure CLI：

   az login
   

2. 列出当前Static Web App的所有环境，确认要删除的目标：

   az staticwebapp environment list --name <你的静态应用名称> --resource-group <对应的资源组名称>
   

3. 删除指定的staging环境：

   az staticwebapp environment delete --name <应用名称> --resource-group <资源组名称> --environment-name <要删除的环境名称>
   

   注意：环境名称可以从上面的列表命令结果里获取，通常是pr-<PR号>或者分支的标识名

方法3：配置自动清理，避免再次触发超限 #

为了以后不用手动清理，你可以设置自动删除闲置或已关闭PR对应的staging环境：

• 通过GitHub Workflow自动清理：在你的部署Workflow文件中，添加针对pull_request_closed事件的处理步骤，调用官方部署动作来删除对应环境。比如在部署job里补充：

  on:
    pull_request:
      types: [opened, synchronize, closed]
  jobs:
    build_and_deploy_job:
      if: github.event.action == 'opened' || github.event.action == 'synchronize'
      # 这里保留你原有的部署步骤
    close_job:
      if: github.event.action == 'closed'
      runs-on: ubuntu-latest
      steps:
        - name: Delete staging environment
          uses: Azure/static-web-apps-deploy@v1
          with:
            azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
            action: "delete"
            app_location: "/" # 和你部署时的路径保持一致
            environment_name: ${{ github.event.pull_request.head.ref }}
  

• 通过Azure门户配置自动过期：在Static Web App的Environments页面，找到Automatically delete idle staging environments选项，设置闲置天数（比如7天），系统会自动删除超过这个天数没有更新的staging环境

清理完多余的staging环境后，你的PR构建任务应该就能正常运行了。

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