Git提交被拒怎么解决?Push失败原因及修复方法
时间:2026-05-01 20:09:54 121浏览 收藏
当Git push被拒时,别慌——这通常是远程分支更新、权限不足、分支保护规则触发或本地配置异常所致;本文系统梳理了五大核心解决路径:先拉取合并或rebase同步最新变更以应对非快进拒绝,再检查远程URL、认证凭证与SSH连接确保权限无误,接着针对分支保护规则灵活选择PR流程或安全强制推送(推荐--force-with-lease),最后修复本地分支跟踪关系让推送更智能;每一步都附带实操命令与关键提示,助你快速定位问题、安全恢复协作节奏。

如果您尝试将代码推送到远程仓库时收到“Git push被拒”的提示,则可能是由于远程分支存在新提交而本地分支未同步、权限不足、分支保护规则触发或强制推送被禁止等原因导致。以下是解决此问题的步骤:
一、拉取远程最新变更并合并
该方法适用于远程分支已有他人提交,而您的本地分支尚未更新,导致推送因非快进(non-fast-forward)被拒绝。Git 默认拒绝覆盖远程历史,需先整合远程更改。
1、在项目根目录打开终端或命令行工具。
2、执行 git pull origin 当前分支名,例如 git pull origin main。
3、若出现合并冲突,手动编辑冲突文件,保存后执行 git add . 和 git commit -m "resolve merge conflicts"。
4、再次运行 git push origin 当前分支名。
二、使用 rebase 同步而非 merge
该方法可保持提交历史线性整洁,避免产生多余的合并提交,适用于希望维持简洁提交图谱的场景。
1、执行 git fetch origin 获取远程最新引用信息。
2、运行 git rebase origin/当前分支名,例如 git rebase origin/main。
3、如遇冲突,解决后执行 git add .,再运行 git rebase --continue。
4、完成 rebase 后执行 git push origin 当前分支名。
三、检查并修正远程仓库 URL 与权限
该方法用于排除因远程地址错误、认证失效或账户无写入权限导致的推送失败,常见于私有仓库或企业 Git 服务。
1、运行 git remote get-url origin 确认远程地址是否正确。
2、若使用 HTTPS 协议,检查凭据管理器中存储的用户名和密码(或个人访问令牌)是否有效;若使用 SSH,确认 ~/.ssh/id_rsa.pub 已添加至 Git 托管平台的 SSH Keys 设置中。
3、执行 ssh -T git@hostname(如 ssh -T git@github.com)测试 SSH 连通性与身份识别。
4、若权限不足,联系仓库管理员确认您在目标分支上拥有 push 权限。
四、绕过分支保护规则(仅限授权用户)
该方法适用于远程仓库启用了分支保护(如 GitHub 的 Branch Protection Rules、GitLab 的 Protected Branches),要求 PR 审查、状态检查通过或禁止强制推送等限制。
1、访问远程仓库网页界面,进入 Settings > Branches 页面,查看当前分支的保护规则详情。
2、若规则要求 Pull Request,需先创建 PR 并通过所有审批与 CI 检查,再由维护者合并。
3、若具备管理员权限且确需跳过检查,可临时禁用对应规则,或使用 git push --force-with-lease(推荐)替代 --force,以防止意外覆盖他人提交。
4、执行强制推送前,务必确认本地分支历史已准确反映预期状态,并通知协作者。
五、修正本地分支跟踪关系
该方法适用于本地分支未正确设置上游(upstream)分支,导致 git push 无法自动识别推送目标,从而报错或推送到错误位置。
1、运行 git branch -vv 查看当前分支是否关联远程分支及关联状态。
2、若显示 [origin/xxx: gone] 或无远程追踪信息,执行 git branch --set-upstream-to=origin/当前分支名 当前分支名。
3、验证设置是否生效:运行 git config --get branch.当前分支名.remote 和 git config --get branch.当前分支名.merge,应分别返回 origin 和 refs/heads/当前分支名。
4、此后可直接使用 git push 而无需指定远程与分支名。
今天关于《Git提交被拒怎么解决?Push失败原因及修复方法》的内容介绍就到此结束,如果有什么疑问或者建议,可以在golang学习网公众号下多多回复交流;文中若有不正之处,也希望回复留言以告知!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
422 收藏
-
203 收藏
-
438 收藏
-
文章 · 软件教程 | 1天前 | vs code · 软件教程 · Auto Save · 编辑器设置 · 代码格式化 · VS Code 自动保存 settings.json Auto Save 保存后格式化356 收藏
-
383 收藏
-
269 收藏
-
文章 · 软件教程 | 3天前 | Redis · 数据库工具 · ttl · 软件教程 · RedisInsight · Key管理 · redis 软件教程 TTL WorkBench RedisInsight Key筛选119 收藏
-
270 收藏
-
文章 · 软件教程 | 4天前 | MySQL · SQL · dbeaver · 软件教程 · 数据库客户端 · mysql 数据库工具 SQL Editor DBeaver Database Navigator465 收藏
-
278 收藏
-
343 收藏
-
105 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习