为何同一提交哈希值对应不同的Git提交历史？

现象回顾 #

我有一个名为sub的Git仓库，为完整哈希75accac4的提交打上了v7.1.2023.227标签，此时main分支的提交历史包含PR 79的变更：

$ git log v7.1.2023.227 --pretty=format:"%h %ad %d"
75accac Tue Aug 15 07:31:15 2023 +0000  (HEAD, tag: v7.1.2023.227)
0406c95 Thu May 25 10:57:32 2023 +0200
e535e85 Mon Aug 14 07:57:40 2023 +0000
[...]

之后在包含sub作为子模块的super仓库中引用该标签，却发现PR 79的变更缺失。检查中间提交0406c95，发现变更并未被移除。

进一步排查发现，查看远程origin/main的提交历史时，标签指向的75accac提交完全没有PR 79的记录：

$ git log origin/main --pretty=format:"%h %ad %d"
6c9a0d3 Tue Aug 15 07:38:29 2023 +0000  (origin/main)
75accac Tue Aug 15 07:31:15 2023 +0000  (tag: v7.1.2023.227)
0406c95 Thu May 25 10:57:32 2023 +0200
08f73ff Mon Aug 14 08:37:18 2023 +0000
14232e7 Mon Aug 14 08:35:17 2023 +0000
ce979ae Mon Aug 14 08:34:23 2023 +0000
04bd5ff Mon Aug 14 08:29:52 2023 +0000
e535e85 Mon Aug 14 07:57:40 2023 +0000
[...] 

原因分析 #

最可能的情况：哈希简写冲突 #

你看到的75accac是Git提交哈希的简写形式（默认取前7位），而非完整的40位SHA-1哈希。实际场景中，两个不同的提交可能出现前7位哈希相同的情况（概率极低但并非不可能），导致你误以为它们是同一个提交，但实际上是两个完全独立的提交对象：

• 本地仓库的标签v7.1.2023.227指向的是完整哈希为75accac4xxxxxx...的提交，该提交的父提交链包含PR 79的变更
• 远程origin/main中的75accac是另一个完整哈希为75accac4yyyyyy...的提交，其历史链不包含PR 79的变更

这种情况下，Git会将它们视为完全不同的提交，自然会出现历史不一致、变更缺失的问题。

验证方式 #

执行以下命令查看完整提交哈希，确认是否为同一提交：

# 查看本地标签对应的完整哈希
git rev-parse v7.1.2023.227

# 查看远程origin/main中对应位置的完整哈希
git rev-parse origin/main^1

如果输出的完整哈希不同，即可确认是哈希简写冲突导致的误解。

极端情况：SHA-1哈希碰撞（几乎不可能） #

如果完整哈希确实相同，那就是罕见的SHA-1哈希碰撞。此时两个提交的所有元数据（文件快照哈希、父提交、作者信息、提交消息等）完全一致，Git会认为是同一个提交。这种情况下历史不一致的原因可能是仓库中使用了git replace操作修改了提交的父指向，但这会破坏Git的哈希完整性，一般不推荐使用。

解决办法 #

1. 重新推送正确的标签到远程，覆盖错误的标签指向：

   git push origin v7.1.2023.227 --force
   

2. 在super仓库中更新子模块引用：

   git submodule update --remote sub
   

3. 后续尽量使用完整提交哈希或更长的简写（比如10位）来避免冲突。

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