AWS Amplify中yarn build构建失败求助（Vite React-TS项目）

问题核心原因 #

AWS Amplify默认构建环境基于Amazon Linux 2，其自带的GLIBC版本为2.26，而你当前使用的Node.js版本依赖更高的GLIBC 2.27/2.28，导致版本不兼容触发报错。

可行解决方案 #

方案1：切换到Amazon Linux 2023构建环境 #

Amazon Linux 2023自带GLIBC 2.36，完全满足高版本Node.js的依赖要求：

1. 登录AWS Amplify控制台，进入目标应用
2. 点击左侧菜单的构建设置
3. 在构建镜像下拉框中选择Amazon Linux 2023
4. 保存设置后重新触发构建

方案2：指定兼容Amazon Linux 2的Node.js版本 #

若需继续使用Amazon Linux 2环境，需安装针对GLIBC 2.26编译的Node.js版本（如Node 16.20.2，Node 16系列最后一个兼容版本；或Node 18.17.0，Node 18系列最后一个兼容版本）。修改你的amplify.yml配置如下：

version: 1
frontend:
  phases:
    preBuild:
      commands:
        - nvm install 16.20.2
        - nvm use 16.20.2
        - yarn install
    build:
      commands:
        - yarn run build
  artifacts:
    baseDirectory: dist/
    files:
      - '**/*'
  cache:
    paths:
      - node_modules/**/*

方案3：验证package.json的engines配置 #

确保package.json中指定的Node版本与构建环境使用的版本一致，避免版本冲突：

{
  "engines": {
    "node": "16.20.2",
    "yarn": "^1.22.0"
  }
}

验证步骤 #

修改配置后手动触发Amplify构建，检查日志是否仍出现GLIBC相关错误。若构建成功，说明版本兼容问题已解决。

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