GitLab 认证失败解决：使用 Personal Access Token 替代密码

GitLab 认证失败解决方案

这是 GitLab 常见的 HTTP 认证问题，核心原因只有一个：

GitLab 已不支持账号密码方式拉取代码，必须使用 Personal Access Token（访问令牌）

下面一步一步解决：

---

一、问题原因说明

报错关键信息：

you're required to use a token instead of a password

说明：

• ❌ 你现在用的是 用户名 + 密码
• ✅ GitLab 已强制改为 用户名 + Access Token
• 或：你本地缓存了 错误/过期的凭据

---

二、正确解决方案

步骤 1：在 GitLab 上生成 Access Token

1. 打开 GitLab 页面
2. 右上角头像 → Preferences（偏好设置）
3. 左侧 → Access Tokens
4. 填写：
   • Name：随便写（如 git-clone）
   • Expiration date：建议选一个未来日期
   • Scopes（权限）：
     • ✅ read_repository
     • （如果要 push，再勾 write_repository）
5. 点击 Create personal access token
6. ⚠️ 复制生成的 token（只显示一次）

步骤 2：使用 Token clone

执行 clone：

git clone https://<your-git-server>/group/project.git

当提示输入：

Username: Password:

请输入：

• Username：你的 GitLab 用户名（不是邮箱）
• Password：👉 刚生成的 Access Token（不是账号密码）

✔️ 成功

---

三、如果你之前输错过

如果你 之前输过密码，Git 会缓存错误凭据，必须清掉。

Windows（当前环境）

方法 1：控制面板清缓存

1. 控制面板 → 凭据管理器
2. Windows 凭据
3. 删除所有包含：
   • <your-git-server>
   • git:<your-git-server>
4. 重新执行 git clone