为何AWS Amplify无法识别已更新的Node版本？

问题原因 #

报错的根本原因是你修改的所有配置都仅作用于本地开发环境，AWS Amplify的云端构建环境使用的默认Node版本仍为12.21.0，不满足你项目要求的>=12.22.0的版本规则，因此在云端执行依赖安装步骤时触发了兼容性报错。

解决方案 #

方案1：在Amplify控制台配置Node版本（推荐） #

• 登录AWS Amplify控制台，进入对应项目的「构建设置」页面
• 找到「环境变量」配置板块，新增一条环境变量：
  • 变量名：NODE_VERSION
  • 变量值：16.13.0（或任意满足>=12.22.0要求的Node版本号）
• 保存配置后重新触发构建即可生效

方案2：修改构建配置文件指定Node版本 #

在项目根目录的amplify.yml文件中，调整install阶段的执行命令，手动指定构建使用的Node版本，示例配置如下：

phases:
  install:
    commands:
      - n 16.13.0
      - node -v
      - yarn install

将修改后的amplify.yml提交到代码仓库，重新推送代码触发构建即可。

方案3：临时跳过引擎校验（不推荐） #

如果仅需要快速绕过校验，可以修改依赖安装命令为yarn install --ignore-engines，该方案会跳过Node版本校验，但可能存在后续运行时兼容性风险，仅建议临时测试使用。

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