问题：`git push origin master:master` 报错 "Access denied" 如何解决？

Question

在使用 `git push origin master:master` 命令推送代码时，若遇到 “Access denied” 错误，通常是因为当前用户没有目标仓库的写入权限。常见原因包括：SSH 密钥未正确配置、使用了错误的远程仓库地址（如 HTTPS 与 SSH 混淆）、或 Git 凭据缓存过期。解决方法包括：检查远程仓库地址是否正确（`git remote -v`），确认 SSH 密钥已添加至 SSH 代理并关联 Git 账号，或尝试重新输入正确的用户名和密码（针对 HTTPS 方式）。此外，确认是否有权限向目标分支推送，必要时联系仓库管理员。

Answer 1

一、问题现象

在执行 git push origin master:master 命令时，遇到如下错误信息：

ERROR: Permission to <repository> denied to <username>.
  fatal: Could not read from remote repository.
  Please make sure you have the correct access rights

该错误提示表明当前用户没有向目标仓库的写入权限，常见于权限配置错误或认证失败。

二、常见原因分析

• SSH 密钥未正确配置：未生成密钥对，或未将公钥添加到 Git 账户。
• 远程仓库地址错误：使用了 HTTPS 地址但配置了 SSH 认证，或反之。
• Git 凭据缓存过期：HTTPS 模式下凭据失效，未重新输入。
• 权限不足：当前用户在仓库中没有向目标分支推送的权限。

三、排查流程图

graph TD
    A[执行 git push origin master:master] --> B{Access denied?}
    B -- 是 --> C[检查远程仓库地址]
    C --> D{是否为 HTTPS?}
    D -- 是 --> E[检查 Git 凭据缓存]
    D -- 否 --> F[检查 SSH 密钥配置]
    F --> G[是否添加到 SSH Agent?]
    G -- 是 --> H[是否绑定 Git 账号?]
    H -- 否 --> I[上传公钥到 Git 账号]
    G -- 否 --> J[添加私钥到 SSH Agent]
    E --> K[重新输入用户名和密码]
    B -- 否 --> L[其他问题]

四、解决方案详解

1. 检查远程仓库地址

   git remote -v

   确认输出是否为 HTTPS 或 SSH 格式。例如：

   类型	示例地址
   HTTPS	https://github.com/username/repo.git
   SSH	[e-mail]:username/repo.git

2. 切换远程地址类型（如需）

   git remote set-url origin [e-mail]:username/repo.git # 切换为 SSH
   git remote set-url origin https://github.com/username/repo.git # 切换为 HTTPS

3. SSH 密钥配置
   • 生成密钥对（如未生成）：

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

   • 添加私钥到 SSH Agent：

     eval "$(ssh-agent -s)"
     ssh-add ~/.ssh/id_rsa

   • 复制公钥内容并添加至 Git 账号：

     cat ~/.ssh/id_rsa.pub

4. HTTPS 模式下凭据处理

   git config --global credential.helper cache
   git config --global credential.helper 'cache --timeout=3600'

   若缓存已过期或未设置，系统会提示重新输入用户名和密码。
5. 确认仓库权限

   联系仓库管理员确认当前账号是否拥有向 master 分支推送的权限。某些 Git 平台（如 GitHub、GitLab）支持细粒度的权限控制。

五、进阶建议与最佳实践

为避免类似问题再次发生，建议采取以下措施：

• 使用 SSH 方式进行代码推送，避免频繁输入用户名和密码。
• 定期更新 SSH 密钥，并在 Git 平台上同步更新。
• 使用 ~/.ssh/config 文件配置多个 Git 账号的 SSH 别名。
• 启用 Git 的凭证缓存机制，提升 HTTPS 使用体验。
• 在 CI/CD 环境中使用 Personal Access Token（PAT）代替密码。