无法切换Git分支：子模块指定提交已不存在于远程仓库

问题背景 #

克隆含子模块的仓库后执行git clone ... foo && cd foo && git submodule update --init完成初始化，在master分支切换到bar分支时失败，Git无法正常检出子模块，错误信息如下：

fatal: failed to unpack tree object
error: Submodule 'x' could not be updated.
error: Cannot update submodule:
x
Aborting

经排查，子模块曾指向的提交已不存在于远程仓库，但当前仓库中子模块文件指向的提交本地存在，且无法访问能检出对应提交的仓库，需仅通过本地Git操作解决。

修复步骤 #

• 强制切换目标分支（跳过子模块更新）
  先绕过子模块问题，直接切换到bar分支：

  git checkout bar --no-recurse-submodules
  

• 修正子模块指向

  1. 进入子模块目录，确认本地存在的有效提交哈希：

     cd x
     git log --oneline
     

     记录下要使用的有效提交哈希（如abc123）。
  2. 检出该有效提交：

     git checkout abc123
     

  3. 返回主仓库，更新子模块的跟踪状态：

     cd ..
     git add x
     

• 提交修复结果
  提交主仓库中子模块指向的修改：

  git commit -m "Fix submodule x to valid local commit"
  

• 后续子模块更新（可选）
  之后若需更新子模块，可执行：

  git submodule update --init --recursive --force x
  

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