Gitlab丢失refs文件夹提交不可见 无客户端文件如何重建引用

提示：操作前请完整备份整个appX.git目录，避免操作失误损坏仅存的object文件，造成不可逆损失。

前置操作：重建基础目录结构 #

首先进入服务端的裸仓库目录，重建refs的默认子目录：

cd /path/to/appX.git
mkdir -p refs/heads refs/tags

步骤1：提取所有commit记录定位分支头部 #

所有提交记录都存储在完好的object目录中，执行以下命令按提交时间从新到旧列出所有commit：

git fsck --no-reflog | grep 'commit ' | awk '{print $3}' | while read commit_hash; do
    echo "$(git show -s --format="%ct %H 提交说明: %s 提交人: %an" $commit_hash)";
done | sort -rn

返回结果中可以根据提交说明、提交人信息，定位到各个分支对应的最新提交哈希值。

步骤2：重建分支引用 #

以恢复主分支main为例，假设上一步定位到的主分支最新提交哈希为a1b2c3d4e5f6，执行命令：

git update-ref refs/heads/main a1b2c3d4e5f6

其他分支按照相同逻辑，替换命令中的分支名、对应提交哈希即可完成重建。

步骤3：重建标签引用（可选） #

如果需要恢复历史标签，先执行命令列出所有tag对象：

git fsck --no-reflog | grep 'tag ' | awk '{print $3}' | while read tag_hash; do
    echo "标签名: $(git show -s --format="%s" $tag_hash) 对应提交哈希: $(git rev-parse $tag_hash^{commit})"
done

根据返回结果重建标签：

# 重建轻量标签
git update-ref refs/tags/<标签名> <对应提交哈希>
# 重建附注标签
git update-ref refs/tags/<标签名> <标签对象哈希>

步骤4：验证恢复结果 #

执行以下命令确认引用恢复正常：

# 查看所有分支
git branch -a
# 查看所有标签
git tag -l
# 查看完整提交链
git log --oneline --graph --all

确认无误后执行git gc整理仓库对象即可。

GitLab侧缓存刷新 #

仓库引用恢复完成后，需要刷新GitLab的项目缓存，在GitLab服务端执行以下命令：

# 替换为你实际的项目上级目录，触发仓库重新导入
gitlab-rake gitlab:import:repos['/path/to/parent/dir/of/appX.git']
# 可选：清空项目缓存
gitlab-rake cache:clear:rails

刷新完成后重新访问GitLab项目页面，即可正常显示仓库文件列表。

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