重写子模块历史后修复Git子模块SHA指向问题

前提说明 #

你需要先准备好重写后的子模块仓库本地副本，以及父仓库的本地克隆版本，所有操作都基于本地仓库完成。

具体操作步骤 #

核心思路是遍历父仓库的每一个提交，根据该提交的时间戳，在重写后的子模块仓库中找到对应时间点之前的最新提交，再替换父仓库对应提交里的子模块SHA，最后重写父仓库历史。

1. 编写批量处理脚本
   用bash脚本自动化完成遍历与替换操作，示例如下：

   #!/bin/bash
   
   # 配置路径：父仓库中子模块的相对路径
   SUBMODULE_PATH="your/submodule/path"
   # 重写后的子模块本地仓库绝对路径
   SUBMODULE_REPO="/local/path/to/rewritten/submodule"
   
   # 按时间顺序遍历父仓库所有提交
   git log --reverse --format="%H %at" | while read COMMIT_HASH COMMIT_TIMESTAMP; do
       echo "正在处理提交 $COMMIT_HASH..."
   
       # 进入子模块仓库，获取指定时间戳前的最新提交SHA
       cd "$SUBMODULE_REPO"
       NEW_SUB_SHA=$(git log --before="$COMMIT_TIMESTAMP" --format="%H" -n 1)
       cd - > /dev/null
   
       # 获取父仓库当前提交中记录的子模块原始SHA
       ORIG_SUB_SHA=$(git show "$COMMIT_HASH:$SUBMODULE_PATH" | head -n 1)
   
       # 若原始SHA与新SHA不一致，则修改并提交
       if [ "$ORIG_SUB_SHA" != "$NEW_SUB_SHA" ]; then
           git checkout "$COMMIT_HASH"
           # 更新子模块指向新SHA
           echo "$NEW_SUB_SHA" > "$SUBMODULE_PATH"
           git add "$SUBMODULE_PATH"
           # 保留原提交的作者、时间信息，仅修改子模块SHA
           GIT_COMMITTER_DATE="$(git show -s --format="%ci" "$COMMIT_HASH")" git commit --amend --no-edit --date="$(git show -s --format="%ci" "$COMMIT_HASH")"
       fi
   done
   
   # 确认无误后推送到远程（此操作会重写父仓库历史，需提前告知团队成员）
   # git push --force
   

2. 关键注意事项

   • 该操作会重写父仓库历史，多人协作场景下必须提前同步所有团队成员，确保他们知晓后续的本地历史同步方案
   • 时间匹配是近似值：父仓库提交时间与子模块提交时间可能存在偏差，可根据实际情况调整--before的时间范围（比如追加+2 hours缓冲）
   • 建议先在测试分支执行脚本，验证结果符合预期后再操作主分支
   • 若父仓库包含多个子模块，需修改脚本批量处理每个子模块路径

3. 验证修复结果
   处理完成后，可通过以下命令逐一验证父仓库提交的子模块SHA有效性：

   git log --format="%H %ci" | while read COMMIT_HASH COMMIT_DATE; do
       SUB_SHA=$(git show "$COMMIT_HASH:$SUBMODULE_PATH" | head -n 1)
       echo "提交 $COMMIT_HASH ($COMMIT_DATE) -> 子模块SHA: $SUB_SHA"
       # 检查该SHA是否存在于重写后的子模块仓库中
       git -C "$SUBMODULE_REPO" cat-file -e "$SUB_SHA" && echo "✓ SHA有效" || echo "✗ SHA不存在"
   done
   

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