Gitlab网页端删除分支后创建同名分支提示已存在问题咨询

问题原因 #

该问题由GitLab远程仓库未清理的残留分支引用导致，常见残留来源包括未同步的远程引用缓存、废弃合并请求绑定的分支记录、受保护分支规则残留等。

解决步骤 #

• 清理本地远程引用缓存，同步远程仓库最新状态：
  git fetch origin --prune
  执行完成后运行git branch -a再次确认本地和远程分支列表中无对应目标分支。
• 强制清理远程端的同名分支残留，将下方命令中的<target-branch>替换为实际需要创建的分支名：
  git push origin --delete <target-branch>
  该命令会直接清除远程端对应分支的所有引用记录，哪怕分支已在前端删除，残留引用也会被清理，执行完成后即可到GitLab网页端尝试创建同名分支。

若上述操作后仍提示分支已存在，执行以下排查操作：

• 进入GitLab对应仓库的「设置」->「仓库」->「受保护的分支」区域，检查是否存在对应分支名的受保护规则，若存在先删除该规则，再尝试创建分支。
• 检查仓库所有合并请求（包含已关闭、已合并状态），确认是否还有合并请求绑定该分支作为源分支，若有废弃的合并请求直接删除，非废弃的修改合并请求的源分支后再尝试创建。
• 进入仓库「管理」->「维护」->「仓库清理」页面，执行一次仓库垃圾回收，清理所有无效引用后再创建分支。

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