如何排查并解决git merge-base在特定环境执行失败的问题？

我想执行以下命令查看当前分支与origin/dev的差异文件：

git diff --name-only HEAD $(git merge-base HEAD remotes/origin/dev)

但目标环境中git merge-base HEAD remotes/origin/dev执行失败，无任何输出且退出码为1。本地环境执行正常，且该分支确实基于dev创建，理应存在共同提交。以下是本地和目标环境的排查输出：

本地环境执行结果 #

> git branch
* myBranch
> git show-ref remotes/origin/dev
6f5795fc6932784342adda78e2507a537beb72c3 refs/remotes/origin/dev
> git show-ref -h HEAD
2fd86bdba9eee8a7041045c96e0d37b3e7d28906 HEAD
6f5795fc6932784342adda78e2507a537beb72c3 refs/remotes/origin/HEAD
> git symbolic-ref HEAD
refs/heads/myBranch
> git rev-parse HEAD
2fd86bdba9eee8a7041045c96e0d37b3e7d28906
> git merge-base HEAD remotes/origin/dev
63ed7a1acdb477a37acba3cc1cdec33048adb260
> git diff --name-only HEAD $(git merge-base HEAD remotes/origin/dev)
myFile.xml

目标环境执行结果 #

> git branch
* myBranch
> git show-ref remotes/origin/dev
6f5795fc6932784342adda78e2507a537beb72c3 refs/remotes/origin/dev
> git show-ref -h HEAD
2fd86bdba9eee8a7041045c96e0d37b3e7d28906 HEAD
> git symbolic-ref HEAD
refs/heads/myBranch
> git rev-parse HEAD
2fd86bdba9eee8a7041045c96e0d37b3e7d28906
> git merge-base HEAD remotes/origin/dev
# exit code 1
> git diff --name-only HEAD $(git merge-base HEAD remotes/origin/dev)
# returns nothing

问题原因分析 #

对比两处输出可以发现：本地和目标环境的分支、HEAD、origin/dev的哈希值完全一致，但目标环境缺少refs/remotes/origin/HEAD的引用，且git merge-base无法找到共同提交。这大概率是因为目标环境的仓库是浅克隆（shallow clone）——浅克隆会截断仓库的提交历史，只保留最近的若干提交，导致Git无法追溯到两个分支的共同祖先，即便分支当前的哈希一致，本地也没有对应的历史数据支撑git merge-base计算。

解决步骤 #

1. 尝试将浅克隆转换为完整克隆：

   git fetch --unshallow
   

2. 如果--unshallow无效（比如远程仓库本身是浅仓库），可以拉取完整的dev分支历史：

   git fetch origin dev:refs/remotes/origin/dev --depth=2147483647
   

3. 重新执行git merge-base HEAD remotes/origin/dev，确认是否返回共同提交哈希，再运行原diff命令即可正常获取差异文件。

另外，也可以检查Git配置，排除是否有gc.pruneExpire或fetch.prune等参数影响历史查找，但最核心的原因还是浅克隆导致的历史缺失。

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