Azure静态Web应用部署React+Bite时Node版本不兼容问题求解

AI 小北

2026-6-30

解决Azure静态Web应用部署时Node版本不兼容问题

报错核心是Azure当前使用的Node版本16.20.2不满足npm@10.4.0的版本要求（需要Node ^18.17.0 || >=20.5.0），可以通过以下几种方法解决：

方法1：添加.nvmrc文件指定Node版本
在项目根目录新建.nvmrc文件，写入需要的Node版本号，比如：
```
18.17.0
```
或者选择20.x系列的LTS版本：
```
20.9.0
```
Azure静态Web应用部署时会自动读取该文件，使用指定的Node版本。
方法2：在package.json中配置engines字段
打开项目的package.json，在根节点添加engines字段，明确指定兼容的Node和npm版本：
```
"engines": {
  "node": "^18.17.0 || >=20.5.0",
  "npm": "^10.4.0"
}
```
部署时Azure会遵循此配置匹配对应的Node环境。
方法3：在GitHub Actions工作流中显式设置Node版本
如果通过GitHub Actions部署，找到项目.github/workflows目录下的配置文件，在安装依赖步骤前添加Node版本设置：
```
- name: 设置Node.js版本
  uses: actions/setup-node@v4
  with:
    node-version: '18.x' # 也可指定具体版本如'18.17.0'、'20.x'
```
确保该步骤在npm install之前执行。