通过GitHub Actions部署Linux前端Web App超时1小时失败求助

问题背景 #

通过Azure Web Apps部署中心集成GitHub Actions，搭建了React前端与.NET8后端两条部署流水线。后端部署正常，但前端流水线运行1小时后失败，部署步骤代码如下：

jobs:
      # Step 5: Deploy the app to Azure Web App
      - name: Deploy web app using Azure credentials
        uses: azure/webapps-deploy@v3
        with:
          app-name: ${{ env.AZURE_WEBAPP_NAME }}
          package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }}

具体错误信息：

"Package deployment using OneDeploy initiated.
Error: Failed to deploy web package to App Service.
Error: Deployment Failed, Error: Failed to deploy web package using OneDeploy to App Service."

已尝试创建自定义流水线、使用az cli部署，问题依旧，azure/webapps-deploy@v3未按预期工作。

排查与解决方法 #

1. 验证前端构建产物的完整性与路径 #

• 确认AZURE_WEBAPP_PACKAGE_PATH指向的路径正确，React构建后默认产物目录为build，需确保流水线已执行npm run build步骤，且build目录存在且包含完整静态文件。
• 清理构建产物中的冗余内容：前端部署只需build目录下的静态资源，不要将node_modules等无关文件打包，避免部署包过大引发超时。

2. 调整Web App部署超时设置 #

在Azure Portal进入目标Web App的配置 > 常规设置，找到部署超时选项，将默认30分钟调整为更长时长（如120分钟），适配前端大量静态文件的部署耗时。

3. 强制切换为Zip部署替代OneDeploy #

修改azure/webapps-deploy@v3的配置，添加deployment-method: zip-deploy参数，跳过OneDeploy使用传统Zip部署，避免OneDeploy处理大量小文件时的超时问题：

- name: Deploy web app using Azure credentials
  uses: azure/webapps-deploy@v3
  with:
    app-name: ${{ env.AZURE_WEBAPP_NAME }}
    package: ${{ env.AZURE_WEBAPP_PACKAGE_PATH }}
    deployment-method: zip-deploy

4. 检查Web App资源配额 #

若前端Web App使用免费/共享层SKU，部署时可能因CPU、内存资源不足导致停滞，建议临时升级到Basic层测试部署，完成后再降级。

5. 获取更详细的部署日志 #

• 在Azure Portal的Web App部署中心 > 日志中，查看OneDeploy的详细执行日志，定位具体失败环节（如文件上传超时、权限异常）。
• 在GitHub Actions流水线中添加调试环境变量，获取azure/webapps-deploy@v3的详细执行日志：

  env:
    ACTIONS_STEP_DEBUG: true
  

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