问题：Git Push权限被拒绝如何解决？

Question

**问题描述：** 在使用 Git 进行代码推送（`git push`）时，可能会遇到权限被拒绝（Permission denied）的错误，尤其是在使用 SSH 或 HTTPS 协议连接远程仓库时。此类问题通常由 SSH 密钥配置错误、权限设置不当、仓库不存在或用户无写入权限引起。如何快速定位并解决 Git Push 权限被拒绝的问题，是开发者在协作开发中必须掌握的技能。本文将介绍几种常见的排查方法与解决方案。

Answer 1

一、问题现象：Git Push 时提示“Permission denied”

在使用 Git 进行代码推送时，开发者常常会遇到如下错误信息：

ERROR: Permission to user/repo.git denied to otheruser.
fatal: Could not read from remote repository.
Please make sure you have the correct access rights...

这类错误通常出现在使用 SSH 或 HTTPS 协议连接远程 Git 仓库（如 GitHub、GitLab、Gitee 等）时，可能的原因包括密钥配置错误、权限不足、仓库不存在等。

二、排查思路：从浅入深，分层定位

1. 检查当前使用的 Git 协议

Git 支持多种协议连接远程仓库，常见的是 HTTPS 和 SSH。不同协议的认证机制不同：

• HTTPS：需要用户名和密码（或 Personal Access Token）
• SSH：需要配置 SSH 密钥并添加到 Git 账户中

查看当前远程仓库地址：

git remote -v

若地址以 https:// 开头则为 HTTPS 协议；若以 git@ 开头则为 SSH 协议。

2. SSH 协议下的常见问题与解决

若使用 SSH 协议，问题通常出在密钥配置或权限设置上。

1. 检查本地是否存在 SSH 密钥对：

2. ls -al ~/.ssh

3. 生成新的 SSH 密钥（如不存在）：

4. ssh-keygen -t rsa -b 4096 -C "[e-mail]"

5. 将公钥添加到 Git 平台账户设置中：

6. cat ~/.ssh/id_rsa.pub

7. 测试 SSH 连接是否正常：

8. ssh -T [e-mail]

3. HTTPS 协议下的常见问题与解决

使用 HTTPS 协议时，Git 会提示输入用户名和密码。由于 GitHub 等平台已弃用密码登录，需使用 Personal Access Token 替代。

解决步骤如下：

1. 前往 Git 平台生成 Personal Access Token（PAT）
2. 使用如下命令缓存凭证：

3. git config --global credential.helper store

4. 首次推送时输入用户名和 PAT 作为密码

三、进阶排查：权限与仓库状态

1. 检查用户对仓库的访问权限

确保当前 Git 用户对目标仓库具有写权限。可在 Git 平台的仓库设置中查看成员权限。

2. 检查远程仓库是否存在

推送前确认远程仓库 URL 是否正确：

git remote set-url origin [e-mail]:username/repo.git

3. 检查 SSH 配置文件

编辑 ~/.ssh/config 文件，确保没有冲突配置：

Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_rsa

四、流程图总结

以下是 Git Push 权限被拒绝问题的排查流程图：

graph TD
A[开始] --> B{使用SSH协议?}
B -->|是| C[检查SSH密钥是否存在]
C --> D[是否已添加到Git账户?]
D -->|否| E[添加公钥]
D -->|是| F[测试SSH连接]
F --> G{连接成功?}
G -->|否| H[检查SSH配置]
G -->|是| I[检查仓库权限]
B -->|否| J[使用HTTPS协议]
J --> K[是否配置PAT?]
K -->|否| L[生成并使用PAT]
K -->|是| M[检查仓库权限]
M --> N[结束]
H --> F
L --> N
I --> N
  

五、结语

Git Push 权限问题虽然常见，但只要按照协议类型、密钥配置、权限设置等维度逐步排查，基本可以快速定位并解决。对于有经验的开发者而言，理解 Git 的认证机制和底层流程，有助于在复杂环境中更高效地处理类似问题。