Git 提交報錯「Missing unknown 0000000...」根因與快速修復

Git 提交報錯「Missing unknown 0000000...」根因與快速修復

執行 git commit 時遇到：

Error occurred computing Git commit diffs
Missing unknown 0000000000000000000000000000000000000000

錯誤成因

該錯誤表明 Git 嘗試對比的提交對象（通常是父提交）不存在於本地倉庫。常見場景：

• 淺克隆：git clone --depth=1 只拉取最新提交，歷史斷裂導致找不到父提交。
• 遠端強制推送/變基：遠端歷史被重寫，本地仍持有舊引用。
• 子模組指針失效：子模組指向的提交在遠端被刪除。
• git filter-branch / BFG 重寫歷史後未同步。

快速修復方案

1. 獲取完整歷史（針對淺克隆）：

   git fetch --unshallow

2. 重新同步遠端引用：

   git fetch --all --prune
   git reset --hard origin/<branch>  # 謹慎操作，會丟失本地未推送提交

3. 修復子模組：

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

4. 極端情況：重新克隆：

   cd .. && rm -rf repo && git clone <url>

預防建議

• CI/CD 環境避免使用 --depth=1，或構建前執行 git fetch --unshallow。
• 團隊協作規範：禁止對共享分支強制推送（push --force），改用 push --force-with-lease。
• 定期執行 git gc 維護倉庫健康。

核心原則：確保本地擁有完整的提交鏈，Git 才能正確計算差異並生成提交對象。