这条报错是远端拒绝,不是网络断
看到 error: failed to push some refs to 后面再跟几行 hint,说明请求已经到达远端服务器,被服务端规则挡了回来。原因通常只有三类:远端分支存在本地没有的提交,触发 non-fast-forward;分支开了保护,钩子直接拒绝;当前账号没有写权限。先判断属于哪一类,再决定是合并还是找人开权限。
第一步:fetCh 之后看两边到底差在哪
git fetch origin
git log --oneline --left-right --graph main...origin/main
输出里以 < 开头的是本地独有提交,以 > 开头的是远端独有提交。git status 只会提示 your branch is behind,看不出差了几条、差在什么地方,左右对比的 log 更直接。
第二步:远端有新提交,merge 和 rebase 二选一
git pull --rebase origin main
# 逐个解决冲突后
git add .
git rebase --continue
团队要求线性历史就用 rebase,它会把每个本地提交重放成新的哈希。公共分支上已经推送过的提交不要 rebase,否则同事下次拉取会集体冲突。自己的功能分支用 rebase 更干净,主干上老实 merge 一次,省事也安全。
第三步:确实要覆盖远端,用 --force-with-lease
git push --force-with-lease origin main
直接 --force 会把别人刚推上去的提交抹掉,找回来很麻烦。--force-with-lease 在远端 HEAD 和本地记录的远程引用不一致时直接拒绝,相当于多一道确认。执行前先 git fetch,让本地的 origin/main 保持最新,这道保护才有效。
第四步:钩子与权限类报错不要硬推
如果报错变成 remote: You are not allowed to push code to protected branches 或 pre-receive hook deCLIned,说明代码本身没问题,是分支保护或账号角色不够。正确做法是推到功能分支再提合并请求。返回 403 时检查凭据缓存,看 credential.helper 配的是哪种存储,清掉旧密码后重新认证。
小结
处理顺序固定:先 fetch 比对差异,能快进就快进,不能就 merge 或 rebase,迫不得已才用 --force-with-lease,遇到钩子拒绝就走合并请求。判断清楚再动手,既不用靠 --force 硬顶,也不会把队友的提交推丢。
