如何永久移除Bitbucket中含明文用户名的不可达提交？

核心原因 #

你碰到的问题本质是三点：

• Bitbucket会默认保留不可达提交（即不被任何分支/标签指向的提交）作为缓存，不会立刻删除
• 外部fork的仓库不受你的控制，里面仍保留完整的旧提交历史
• 本地或远程可能还有未清理干净的隐藏引用（比如stash、未跟踪的分支）

解决方案步骤 #

1. 确保本地仓库彻底清理干净

• 先检查所有分支和标签，确认没有遗漏的未处理引用：

  git branch -a
  git tag -l
  

  要是有没处理的分支，切换过去重新用BFG处理后再合并到主分支。
• 清空本地stash（stash里可能藏着旧提交的引用）：

  git stash clear
  

• 执行更彻底的GC命令，确保本地无残留：

  git reflog expire --expire-unreachable=now --all
  git gc --prune=now --aggressive --prune-expire=now
  

2. 强制同步远程并清理Bitbucket服务器缓存

• 强制推送所有分支和标签到远程，覆盖所有旧引用：

  git push --mirror --force
  

• 关键操作：联系Bitbucket官方支持，请求他们手动清理仓库中所有不可达的旧提交。因为Bitbucket不会自动删除这些历史缓存，只有官方能彻底清除服务器端的残留提交。
• 检查仓库设置：进入Bitbucket仓库的「Settings」→「Repository details」，确认没有开启历史保留类的特殊选项（部分私有仓库可能有此设置）。

3. 处理外部fork的扩散问题

• 如果你能联系到fork仓库的维护者，通知他们同步清理后的仓库：
  1. 最简单的方式是删除本地旧仓库，重新克隆你的清理后的版本
  2. 或者在他们的本地仓库执行：

     git remote add upstream 你的仓库地址
     git fetch upstream
     git reset --hard upstream/main  # 替换main为你的主分支名
     git push --force
     

• 如果是私有仓库，可通过Bitbucket管理员删除所有未授权的fork，避免旧提交继续扩散。

4. 验证清理效果

• 克隆仓库到全新的本地目录，搜索是否还有用户名残留：

  git log --all --grep="你的明文用户名"
  git grep "你的明文用户名" $(git rev-list --all)
  

• 等待1-2天（Bitbucket缓存清理周期）后，再次在Bitbucket上搜索旧提交ID，确认是否还能访问。

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