AWS CodeBuild batch配置报Phases found in YAML:0错误排查

直接触发报错的原因 #

CodeBuild对所有buildspec文件（包括批构建的入口buildspec）有强制格式要求：无论文件是否承担实际构建逻辑，都必须包含phases配置段。
你当前放在根目录的入口buildspec.yml仅定义了version和batch配置块，完全没有phases段，CodeBuild扫描时识别不到任何可执行的构建阶段，因此抛出Phases found in YAML: 0错误。

配置存在的隐藏逻辑问题 #

你使用的build-graph批构建模式中，每个identifier对应的构建任务都运行在独立隔离的临时计算环境中，任务之间默认不共享工作目录文件。也就是说即使修复了上述格式错误，install-yarn任务中安装生成的node_modules文件夹也不会同步到后续的build-typescript和lint任务环境中，后两个任务依然会因为缺少依赖执行失败。

1. 给根目录的入口buildspec补全必填的phases段，不需要在入口文件写实际构建逻辑，加最简执行段即可，修复后的入口文件示例：

version: 0.2

batch:
  fast-fail: true
  build-graph:
    - identifier: install-yarn
      buildspec: .aws-codebuild-specs/install-yarn.yml

    - identifier: build-typescript
      buildspec: .aws-codebuild-specs/build-typescript.yml
      depend-on:
        - install-yarn

    - identifier: lint
      buildspec: .aws-codebuild-specs/lint.yml
      depend-on:
        - install-yarn

# 补全必填的phases配置
phases:
  build:
    commands:
      - echo "Start batch build workflow"

2. 解决跨任务依赖不共享的问题，二选一即可：
   • 轻量方案：取消独立的install-yarn任务，直接在build-typescript.yml和lint.yml两个子任务的buildspec开头，增加依赖安装步骤。两个任务并行执行时会各自安装依赖，配置逻辑最简单，适合依赖体积小的项目。
   • 性能优化方案：保留独立安装任务，在install-yarn任务中配置构建缓存，将安装完成的node_modules上传到共享缓存存储；后续两个子任务启动时先从缓存路径拉取node_modules到本地工作目录，再执行编译、lint操作，适合依赖体积大、安装耗时长的项目。

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