部署React应用至Cloudflare Pages时遭遇Node引擎不兼容错误

你遇到的错误是因为Cloudflare Pages默认使用Node.js 12.18.0，但项目依赖的got@12.1.0要求Node版本≥14.16，版本不匹配导致依赖安装失败。以下是两种可行的解决方法：

方法1：通过package.json指定Node版本 #

在项目根目录的package.json中添加engines字段，明确指定项目所需的Node版本：

{
  "engines": {
    "node": ">=14.16.0"
  }
}

Cloudflare Pages会自动识别这个配置，选用符合要求的Node版本执行构建流程。

方法2：在Cloudflare控制台手动设置Node版本 #

1. 登录Cloudflare Pages控制台，找到你的目标项目
2. 进入「Settings」→「Build & deploy」→「Environment variables」页面
3. 添加环境变量：变量名填NODE_VERSION，值设为你本地使用的版本（比如16.15.0）
4. 重新触发项目构建即可

设置完成后重新部署，Cloudflare会使用指定的Node版本安装依赖并构建项目，就能解决这个版本不兼容的问题。

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