AWS CodeBuild报错：buildspec.yaml未找到但根目录已存在该文件

以下是几种常见的导致该报错的原因，即使你本地仓库根目录存在buildspec文件：

• 文件名后缀或大小写不匹配：CodeBuild默认查找的是buildspec.yml（注意是.yml后缀），如果你的文件是buildspec.yaml，或者文件名存在大小写差异（比如BuildSpec.yml），都会导致找不到文件。
• 构建项目配置指定了错误路径：检查CodeBuild项目的"构建规范"配置项，是否手动指定了非根目录的buildspec路径，或者路径/文件名拼写错误（比如误填为src/buildspec.yml）。
• 远程仓库分支无对应文件：你本地有文件，但可能没将buildspec.yml推送到远程仓库的目标分支，或者CodeBuild拉取的是错误的分支。直接查看远程仓库对应分支的根目录确认文件是否存在。
• 工作目录实际为子目录：报错中的CODEBUILD_SRC_DIR是CodeBuild的工作目录，但如果你的源码是从子模块、压缩包或特定子目录拉取的，实际工作目录下的根路径可能没有buildspec文件。可以检查源码来源的配置，确认拉取后的目录结构。
• 文件被.gitignore排除：如果你的.gitignore文件中包含buildspec.yml或buildspec.yaml规则，该文件不会被推送到远程仓库，CodeBuild自然无法读取。
• 文件权限问题：少见但可能存在：CodeBuild服务角色没有读取该文件的权限，或者文件本身的权限设置为不可读，系统会返回类似"找不到文件"的报错。

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