合并GitHub PR后Amplify自动构建失败：appRoot需为字符串

排查与修复步骤 #

• 检查amplify.yml中的appRoot格式
  打开Amplify控制台的构建设置，确认appRoot的值是单个字符串路径。正确配置示例：

  version: 1
  applications:
    - appRoot: "frontend"
      frontend:
        phases:
          preBuild:
            commands:
              - npm install
          build:
            commands:
              - npm run build
        artifacts:
          baseDirectory: build
          files:
            - '**/*'
  

  禁止将appRoot设为数组（如appRoot: ["frontend"]）或空值，必须是指向项目子目录的字符串。

• 验证环境变量对appRoot的影响
  即便未手动修改环境变量，CI/CD流程可能自动注入变量导致解析异常。可在amplify.yml的preBuild阶段添加调试命令，查看实际解析值：

  - echo "解析后的appRoot值: $APP_ROOT"
  

  若输出非预期字符串，排查是否有变量覆盖了appRoot配置。

• 重置Amplify的monorepo配置

  1. 进入应用的App settings > Build settings
  2. 点击Edit修改构建设置
  3. 确认applications数组下的appRoot为正确字符串路径，保存后手动触发构建。

• 检查PR合并后的仓库结构
  确认PR未修改根目录的amplify.yml、package.json，或调整子目录结构导致appRoot指向的路径不存在，路径拼写需完全匹配。

• 更新Amplify CLI（本地管理场景）
  若用本地CLI管理应用，可能是版本兼容问题，更新至最新稳定版：

  npm install -g @aws-amplify/cli
  

  重新推送配置到云端后再触发构建。

内容的提问来源于stack exchange，提问作者Stéfan Martin