AWS Amplify构建失败：Schema括号不匹配错误求助

问题背景 #

• 部署目标：Dev环境下搭建AWS Amplify全栈CI/CD，实现CodeCommit代码推送后自动构建后端资源
• 构建报错：环境初始化时触发语法错误，提示graphql.schema第239行存在意外的)，括号不匹配
• 当前buildspec.yml配置：

version: 0.1
frontend:
  phases:
    preBuild:
      commands:
        - npm i
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: .next
    files:
      - '**/*'
  cache:
    paths:
      - node_modules/**/*

• 已完成的排查操作：
  • 检查graphql.schema是否存在错误
  • 移除buildspec中的测试环节
  • 尝试添加amplify push --simple命令
  • 本地执行npm run build成功

解决方案 #

1. 精准修复Schema括号不匹配问题 #

直接定位到graphql.schema第239行，重点检查：

• 该行及相邻行的括号嵌套结构，比如字段参数、输入类型定义、查询/突变语句中的()配对
• 排查是否存在多余的闭合括号，或者遗漏的开启括号
• 利用IDE的括号高亮匹配功能（如VS Code的括号着色）快速定位异常位置，比如自定义指令、嵌套输入对象中的括号错误

2. 完善buildspec.yml的后端构建逻辑 #

当前配置仅处理前端构建，未触发Amplify后端资源部署，需补充后端构建阶段：

version: 0.1
backend:
  phases:
    build:
      commands:
        - amplify push --simple --yes
frontend:
  phases:
    preBuild:
      commands:
        - npm i
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: .next
    files:
      - '**/*'
  cache:
    paths:
      - node_modules/**/*

确保构建环境中的Amplify CLI已配置足够权限，可访问并部署后端资源。

3. 本地验证Schema合法性 #

本地执行amplify validate命令，专门校验后端Schema语法，避免仅通过npm run build（仅前端编译）无法发现后端Schema错误的情况。

4. 对齐构建环境与本地环境的CLI版本 #

在buildspec的preBuild阶段添加amplify --version命令，查看构建环境使用的CLI版本，确保与本地一致——不同版本的Amplify CLI对Schema的语法校验规则可能存在差异，必要时在构建阶段指定安装特定版本的CLI。

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