AWS CodeBuild经GitHub Webhook触发时DOWNLOAD_SOURCE失败求助

错误原因分析 #

你碰到的问题本质是Git引用路径冲突：当存在feature/pre-promo和feature/pre-promo/base这种嵌套命名的分支时，Git会自动创建feature/pre-promo目录来存放base分支的引用文件。Webhook触发CodeBuild构建时，系统尝试读取这个路径对应的引用文件，但实际它是个目录，因此抛出"is a directory"错误。手动构建正常是因为手动触发时，CodeBuild直接用commit SHA拉取代码，不会去解析这个冲突的引用路径。

可行解决方案 #

• 修改分支命名规则（推荐）：避免用嵌套层级的分支命名，比如把feature/pre-promo/base改成feature/pre-promo-base或feature/pre-promo-base-branch，这样Git就不会生成冲突的目录结构，从根源解决问题。
• 调整Webhook的BASE_REF匹配模式：如果必须保留分支命名结构，可以把匹配模式改得更严格，确保只触发目标分支构建，同时避免CodeBuild解析冲突的引用路径。比如保留^refs/heads/feature/[a-z-]+/base$的同时，删除或重命名feature/pre-promo这类会造成目录冲突的分支。
• 检查CodeBuild源码配置：在CodeBuild项目的源码设置里，确认Webhook触发时用commit SHA作为source version（而非分支引用）。虽然你的错误信息里已经显示source version是SHA，但可以再核对Webhook设置，确保没有额外的引用解析逻辑。

内容的提问来源于stack exchange，提问作者jack.johnson