Gitee 推送报错 400/403 排查与 SSH 协议解决方案

Gitee 代码推送问题排查与解决复盘

1. IDEA 及命令行推送报错现象

现象一：403 Forbidden

• 报错信息：fatal: unable to access '...': The requested URL returned error: 403

现象二：400 Bad Request

• 报错信息：remote: [session-xxx] reject by [gitee] ... error: 400

---

2. 尝试过但失败的方案 (HTTPS)

尝试了以下 HTTPS 修复手段，但因环境干扰未能彻底解决：

1. 清理代理：执行 git config --unset http.proxy
2. 清理凭据：执行 cmdkey /delete 和 git config --unset credential.helper
3. 强制带 Token：直接在 URL 中拼接 Token（导致了 400 错误）。
4. 清除 Windows 的 Gitee 凭据：因无法操作导致未解决。

---

3. 最终解决方案：切换 SSH 协议 (成功)

SSH 协议优势：绕过代理、绕过 Windows 凭据管理器、不需要输入密码，是解决权限问题的'终极方案'。

步骤 1：获取本机 SSH 公钥

在 CMD 或终端执行：

type %USERPROFILE%\.ssh\id_rsa.pub 

(如果没有，使用 ssh-keygen -t rsa -C "[email protected]" 生成)

步骤 2：在 Gitee 添加公钥

复制上一步输出的以 ssh-rsa 开头的完整字符串。 登录 Gitee 网页 -> 设置 -> 安全设置 -> SSH 公钥。 粘贴并保存。

步骤 3：验证连接

使用 ssh -T [email protected]

输入 yes 回车，出现 'successfully authenticated' 即为成功

步骤 4：修改项目远程地址 (关键)

将原来的 https:// 地址修改为 [email protected]: 地址。

在本地项目目录里运行：

git remote set-url origin [email protected]:<username>/<仓库名>.git

步骤 5：强制推送

由于本地重建了 .git 文件夹，历史记录不一致，需要强制覆盖：

git push -f origin master

此时 IDEA 也可以正常推送：