GitLab中解除默认保护并删除主分支的完整指南
1. 为什么需要删除GitLab的主分支？
在实际开发中，我们经常会遇到需要删除主分支的情况。最常见的就是主分支代码已经完全混乱，需要重新建立干净的代码基线。我遇到过几次这样的情况：由于持续集成配置错误，导致大量错误代码被合并到master分支；或者团队刚接手一个历史项目，发现master分支已经积攒了太多技术债务。
主分支（通常是master或main）在GitLab中默认受到特殊保护，这是有充分理由的。作为项目的核心分支，它往往对应着生产环境的代码。GitLab通过两种机制保护主分支：
- 默认分支：这是项目的基准分支，新合并请求默认指向它
- 受保护分支：防止意外推送或删除
要删除这样的分支，我们需要先解除这两重保护。但在此之前，强烈建议先做好三件事：
- 确保所有团队成员都知道这个操作
- 备份当前master分支的完整代码
- 准备好一个临时替代的默认分支
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 master5. 重建主分支的最佳实践
删除旧master后，通常需要建立新的主分支。这里分享几个实战经验：
- 从稳定点重建：从一个已知稳定的提交创建新分支
git checkout -b master <stable_commit_hash> git push -u origin master- 重新配置保护：回到保护设置，为新master启用：
- 允许推送：仅维护者
- 允许合并：仅允许合并请求
- 允许强制推送：不勾选（除非特殊需求）
更新CI/CD配置：检查流水线文件中所有硬编码的
master引用通知团队：更新所有开发环境，重新设置跟踪分支
git branch --set-upstream-to=origin/master master6. 可能遇到的问题与解决方案
6.1 权限不足错误
即使你是项目维护者，也可能遇到权限问题。检查：
- 项目可见性级别（私有项目需要明确授权）
- 你的角色是否被正确设置为Maintainer
- 组级别的分支保护策略是否覆盖了项目设置
6.2 分支删除后流水线失败
有些CI/CD配置会硬编码master分支检查。解决方法：
- 临时禁用相关流水线
- 更新.gitlab-ci.yml中的分支规则
- 检查部署脚本中的分支引用
6.3 恢复误删的分支
如果误删了重要分支，可以通过以下步骤恢复：
- 找到该分支最后的提交哈希
- 从该提交创建新分支
git checkout -b recovered_branch <last_commit_hash>- 推送到远程
git push origin recovered_branch记住，Git的数据不会真正消失，除非执行了垃圾回收。所以发现问题后要立即停止操作，避免GC清理掉可恢复的对象。