GitHub Action部署Azure Web App失败问题排查求助

问题2：创建App Service Plan时提示资源组azwebapp不存在 #

原因 #

脚本大概率硬编码了资源组名称为azwebapp，或者PR详情解析逻辑错误，把默认资源组asgithub-RG覆盖成了azwebapp。

解决方案 #

• 检查步骤2的App Service Plan创建命令，强制指定资源组为asgithub-RG，示例命令：

  az appservice plan create --name ${{ steps.pr-details.outputs.plan-name }} --resource-group asgithub-RG --sku B1 --is-linux
  

• 验证PR详情提取逻辑，比如从PR标题/编号生成资源名称的代码，确保没有错误修改资源组参数。

问题1：部署成功但Web App启动失败，提示找不到../scripts/start模块 #

原因 #

1. 部署的是项目源码而非build后的静态产物，Azure执行npm start时找不到对应模块；
2. React应用的启动脚本不符合Azure Web App的运行环境；
3. 部署步骤未正确上传build文件夹，或未配置静态文件服务的启动命令。

解决方案 #

• 若用Create React App，优先配置静态托管：
  • 在项目根目录创建staticwebapp.config.json，或者在部署后设置启动命令为npx serve -s build（需确保serve已添加到项目依赖）：

    az webapp config set --name ${{ steps.pr-details.outputs.webapp-name }} --resource-group asgithub-RG --startup-file "npx serve -s build"
    

• 检查GitHub Action的部署步骤，确保上传的是build文件夹而非整个源码。比如用Azure/webapps-deploy动作时，指定package: build：

  - name: Deploy to Azure Web App
    uses: Azure/webapps-deploy@v2
    with:
      app-name: ${{ steps.pr-details.outputs.webapp-name }}
      resource-group: asgithub-RG
      package: build
  

• 核对项目package.json的start脚本路径，若部署的是构建产物，无需保留源码中的start脚本依赖。

适配所有仓库的动态资源创建方案 #

• 统一命名规则：基于仓库名、PR编号生成唯一的资源名称，避免冲突，示例：

  PLAN_NAME="plan-${{ github.event.repository.name }}-pr${{ github.event.number }}"
  WEBAPP_NAME="webapp-${{ github.event.repository.name }}-pr${{ github.event.number }}"
  

• 所有CLI命令显式指定资源组asgithub-RG，不要依赖Azure CLI的默认资源组配置；
• 增加资源存在性检查：创建前先判断资源是否已存在，避免重复创建报错，示例：

  if ! az appservice plan show --name $PLAN_NAME --resource-group asgithub-RG; then
    az appservice plan create --name $PLAN_NAME --resource-group asgithub-RG --sku B1 --is-linux
  fi
  

• 封装复用模板：把资源创建、部署步骤做成可复用的GitHub Action模板，不同仓库只需传入仓库名、PR编号等参数即可调用。

临时方案优化 #

• 静态网站托管：直接把build文件夹部署到Azure Storage静态网站，比Web App更轻量，适合纯静态React应用；
• 容器部署：将React应用打包成Docker镜像，推送到Azure Container Registry后部署到Web App for Containers，彻底避免环境依赖问题，Dockerfile示例：

  FROM nginx:alpine
  COPY build/ /usr/share/nginx/html
  EXPOSE 80
  

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