AWS CodeBuild获取变更文件目录命令执行异常问题

问题1：HEAD~1报错的原因 #

AWS CodeBuild默认采用浅克隆（git clone --depth 1），只拉取仓库最新的一次提交，没有完整的Git历史。这就导致HEAD~1这个指向父提交的引用不存在，直接执行会抛出"unknown revision"错误。

问题2：替换为$CODEBUILD_WEBHOOK_HEAD_REF后输出为空的原因 #

CODEBUILD_WEBHOOK_HEAD_REF的值是当前构建对应的分支/标签引用（比如refs/heads/main），而HEAD本身就指向这个引用的最新提交，两者对比自然没有差异，所以输出为空。

解决方案 #

1. 调整CodeBuild的Git克隆深度 #

进入你的CodeBuild项目配置页面，找到源码设置区域：

• 将"Git clone depth"从默认的1修改为一个足够大的数值（比如50，满足大多数场景的历史查询需求），或者设置为0拉取完整仓库历史。
• 保存配置后重新触发构建，此时HEAD~1就能正常识别父提交了。

2. 针对Webhook触发的构建使用正确的对比基准 #

如果你的构建是由GitHub Webhook触发的，应该用CODEBUILD_WEBHOOK_BASE_REF（变更前的分支/标签引用）和HEAD做对比，这才是本次变更的前后差异。修改后的命令如下：

git diff --dirstat=files,0 $CODEBUILD_WEBHOOK_BASE_REF HEAD | awk '{print $2}' | xargs -I {} dirname {} | awk -F '/' '{print $1}' | sort | uniq

3. 兼容手动触发的构建场景 #

如果存在手动触发构建的情况，CODEBUILD_WEBHOOK_BASE_REF会为空，此时可以 fallback 到用HEAD~1作为对比基准，同时增加判断避免报错：

if [ -n "$CODEBUILD_WEBHOOK_BASE_REF" ]; then
  git diff --dirstat=files,0 $CODEBUILD_WEBHOOK_BASE_REF HEAD | awk '{print $2}' | xargs -I {} dirname {} | awk -F '/' '{print $1}' | sort | uniq
else
  git diff --dirstat=files,0 HEAD~1 HEAD | awk '{print $2}' | xargs -I {} dirname {} | awk -F '/' '{print $1}' | sort | uniq
fi

4. 验证Git历史是否可用 #

在buildspec的install或pre_build阶段添加以下命令，确认Git历史已正常拉取：

git log --oneline -n 5

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