本地查询单文件git log记录与GitLab CI执行结果不一致问题

问题诱因排查 #

核心原因：GitLab CI默认浅克隆策略 #

• GitLab Runner执行流水线时默认开启浅克隆（shallow clone） 优化，默认配置的GIT_DEPTH参数仅会拉取最近20条提交记录（部分旧版本默认值为1）。如果index.html的最后一次提交不在浅克隆拉取的提交范围内，Git无法匹配到该文件对应的提交历史，就会默认返回当前HEAD指向的仓库最新提交，也就是你观测到的README.md对应的提交记录。
• 你可以在CI脚本中新增命令git rev-parse --is-shallow-repository验证该问题，如果返回结果为true即可确认是浅克隆导致。

其他可能诱因 #

• CI执行命令的工作目录不对：如果CI任务的执行路径不是仓库根目录，会导致index.html路径不存在，Git会默认查询整个仓库的提交历史。你可以在CI中新增pwd、ls index.html命令确认文件是否存在、路径是否正确。

修复方案 #

在.gitlab-ci.yml中新增全局或对应任务的变量配置，关闭浅克隆拉取完整历史：

variables:
  GIT_DEPTH: 0

如果不想拉取全量提交历史，也可以将GIT_DEPTH设置为足够大的数值，覆盖到index.html最后一次提交的深度即可。

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