GitHub Actions通过ZIP Deploy部署Azure Web App失败的解决方法

常见排查方向及修复步骤 #

1. 修正打包命令的路径问题 #

你当前的打包命令zip -r release.zip ./* -x "logs/*" ".env" "node_modules/*"可能遗漏了根目录的隐藏文件（如.gitignore、package-lock.json），导致Azure构建时缺少必要配置。建议调整为：

zip -r release.zip . -x "logs/*" ".env" "node_modules/*" ".git/*" ".github/*"

用.代替./*可确保根目录所有内容（含隐藏文件）被打包，同时精准排除不需要的目录。

2. 确认构建依赖文件完整 #

开启SCM_DO_BUILD_DURING_DEPLOYMENT=true后，Azure会自动执行构建流程，若ZIP包中缺少package.json或锁文件，会直接导致构建失败：

• 检查ZIP包内是否包含package.json和package-lock.json/yarn.lock；
• 若项目需要特定Node.js版本，在package.json中添加版本约束：

  "engines": {
    "node": "18.x"
  }
  

3. 查看详细部署日志定位具体错误 #

错误提示指向日志，可通过两种方式获取详情：

• 登录Azure门户，进入目标Web App，选择左侧部署中心 > 日志，查看完整构建/部署日志，里面会明确标注错误原因（如依赖安装失败、构建命令报错）；
• 在GitHub Actions的部署步骤中，展开azure/webapps-deploy@v2的详细输出，获取更具体的错误信息。

4. 校验GitHub Actions部署配置 #

确保部署步骤的参数正确：

- name: Deploy to Azure Web App
  uses: azure/webapps-deploy@v2
  with:
    app-name: '你的应用名称'
    slot-name: 'production'
    package: ./release.zip
    publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}

重点确认package参数指向的ZIP文件路径是否正确，避免因路径错误导致部署找不到包。

5. 切换构建环境验证问题 #

若以上步骤无效，可临时将SCM_DO_BUILD_DURING_DEPLOYMENT设为false，提前在GitHub Actions中完成构建再打包部署：

- name: 安装依赖
  run: npm install
- name: 构建项目
  run: npm run build
- name: 打包构建产物
  run: zip -r release.zip ./dist/* # 根据你的实际构建输出目录调整

这种方式可排除Azure端构建的问题，确认是否为构建流程本身的错误导致部署失败。

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