Azure静态Web应用GitHub Action部署遇不支持引擎错误

问题原因 #

Azure静态Web应用的默认GitHub Action工作流未自动适配Angular 17.x对Node.js的版本要求（^18.13.0或>=20.9.0），默认使用了v16.20.2版本，导致npm抛出EBADENGINE警告，进而引发构建部署失败。

解决方案 #

1. 在GitHub Action中显式指定Node.js版本 #

修改你的GitHub Action配置文件，在构建步骤前添加setup-node动作，指定符合要求的Node.js版本：

jobs:
  build_and_deploy_job:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          submodules: true
      # 新增步骤：指定Node.js版本
      - uses: actions/setup-node@v4
        with:
          node-version: '18.x' # 也可选择'20.x'，按需调整
          cache: 'npm'
      - name: Build And Deploy
        id: builddeploy
        uses: Azure/static-web-apps-deploy@v1
        with:
          azure_static_web_apps_api_token: ${{ secrets.AZURE_STATIC_WEB_APPS_API_TOKEN }}
          repo_token: ${{ secrets.GITHUB_TOKEN }}
          action: "upload"
          app_location: "/" # 你的Angular项目根目录，按实际路径调整
          api_location: "" # 无后端API则留空
          output_location: "dist/你的项目名称" # Angular构建输出目录，比如dist/my-angular-app

2. 同步package.json的engines配置 #

在package.json中明确标注Node.js版本范围，让npm和CI流程能自动校验版本合规性：

{
  "engines": {
    "node": "^18.13.0 || >=20.9.0",
    "npm": "^9.3.1 || >=10.2.3"
  }
}

完成以上配置后，GitHub Action会使用指定的Node.js版本执行构建，完全匹配Angular 17.x的依赖要求，即可解决EBADENGINE警告问题。

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