GitLab中解除默认保护并删除主分支的完整指南

1. 为什么需要删除GitLab的主分支？

在实际开发中，我们经常会遇到需要删除主分支的情况。最常见的就是主分支代码已经完全混乱，需要重新建立干净的代码基线。我遇到过几次这样的情况：由于持续集成配置错误，导致大量错误代码被合并到master分支；或者团队刚接手一个历史项目，发现master分支已经积攒了太多技术债务。

主分支（通常是master或main）在GitLab中默认受到特殊保护，这是有充分理由的。作为项目的核心分支，它往往对应着生产环境的代码。GitLab通过两种机制保护主分支：

• 默认分支：这是项目的基准分支，新合并请求默认指向它
• 受保护分支：防止意外推送或删除

要删除这样的分支，我们需要先解除这两重保护。但在此之前，强烈建议先做好三件事：

1. 确保所有团队成员都知道这个操作
2. 备份当前master分支的完整代码
3. 准备好一个临时替代的默认分支

2. 解除分支保护的关键步骤

2.1 进入受保护分支设置

首先登录GitLab，导航到目标项目。在左侧菜单中找到"设置"（Settings）> "仓库"（Repository），然后向下滚动到"受保护的分支"（Protected branches）部分。这里会列出所有受保护的分支及其权限设置。

我曾经在一个紧急修复时犯过错误——直接在搜索框找"保护设置"，结果浪费了十分钟。记住这个设置藏在仓库设置深处是有道理的，毕竟它关系到项目安全。

2.2 解除master分支保护

在受保护分支列表中，找到master分支对应的行。你会看到右侧有个"解除保护"（Unprotect）按钮。点击前请确认：

• 没有正在运行的流水线依赖这个分支
• 没有未完成的合并请求指向它
• 已经通知团队暂停向该分支推送代码

点击解除后，GitLab会立即移除对该分支的保护。这时候master分支就变成了普通分支，但还不能删除，因为它仍然是默认分支。

3. 修改默认分支设置

3.1 选择临时默认分支

转到"设置" > "常规"（General），展开"默认分支"（Default branch）选项。点击下拉菜单，选择一个其他分支作为临时默认分支。我通常会创建一个名为temp_default的空分支专门用于这种过渡期。

这里有个实用技巧：提前准备好这个临时分支，确保它：

• 包含一个README.md文件（空分支可能导致问题）
• 通过所有CI检查
• 有基本的项目结构

3.2 处理合并请求重定向

修改默认分支后，GitLab会询问是否要将开放的合并请求重定向到新默认分支。根据实际情况选择：

• 如果确定要完全废弃旧master，选择"是"
• 如果需要保留部分MR，选择"否"并手动处理

记得通知团队成员更新他们的本地仓库配置，特别是那些设置了git push origin master自动化脚本的同事。

4. 安全删除master分支

4.1 通过Web界面删除

现在可以回到"仓库" > "分支"页面，找到master分支。你会发现删除按钮（红色垃圾桶图标）已经可用。点击后GitLab会要求确认，因为这个操作不可逆。

建议在点击前再次确认：

• 已经打好了必要的标签（Tag）保存重要版本
• 所有关键提交都已经合并到其他分支
• 备份了完整的仓库历史

4.2 通过Git命令删除

对于习惯命令行的开发者，也可以这样操作：

# 首先确保本地和远程都切换到临时分支 git checkout temp_default git push origin temp_default # 删除远程master分支 git push origin --delete master # 清理本地分支（可选） git branch -D master

5. 重建主分支的最佳实践

删除旧master后，通常需要建立新的主分支。这里分享几个实战经验：

1. 从稳定点重建：从一个已知稳定的提交创建新分支

git checkout -b master <stable_commit_hash> git push -u origin master

2. 重新配置保护：回到保护设置，为新master启用：

• 允许推送：仅维护者
• 允许合并：仅允许合并请求
• 允许强制推送：不勾选（除非特殊需求）

3. 更新CI/CD配置：检查流水线文件中所有硬编码的master引用

4. 通知团队：更新所有开发环境，重新设置跟踪分支

git branch --set-upstream-to=origin/master master

6. 可能遇到的问题与解决方案

6.1 权限不足错误

即使你是项目维护者，也可能遇到权限问题。检查：

• 项目可见性级别（私有项目需要明确授权）
• 你的角色是否被正确设置为Maintainer
• 组级别的分支保护策略是否覆盖了项目设置

6.2 分支删除后流水线失败

有些CI/CD配置会硬编码master分支检查。解决方法：

1. 临时禁用相关流水线
2. 更新.gitlab-ci.yml中的分支规则
3. 检查部署脚本中的分支引用

6.3 恢复误删的分支

如果误删了重要分支，可以通过以下步骤恢复：

1. 找到该分支最后的提交哈希
2. 从该提交创建新分支

git checkout -b recovered_branch <last_commit_hash>

3. 推送到远程

git push origin recovered_branch

记住，Git的数据不会真正消失，除非执行了垃圾回收。所以发现问题后要立即停止操作，避免GC清理掉可恢复的对象。