解决IDEA拉取GitLab项目报错：必须为访问令牌授予作用域[api, read user]

项目场景：

环境配置：

IDEA 2024.1

GitLab 项目（私有仓库）

使用HTTP协议克隆仓库

提示信息：

---

问题描述

1. 插件强制API认证

• IDEA的GitLab插件会覆盖Git原生认证流程，要求使用OAuth令牌

2. 令牌权限不足，插件要求令牌必须包含以下作用域

• api：访问GitLab API
• read_user：读取用户信息
• read_repository：读取仓库内容（隐式要求）

3. 认证机制冲突

• 当插件存在时，IDEA不会弹出账号密码输入框，直接使用缓存的令牌

---

解决方案：

1.通过禁用插件回退到基础认证流程，绕过API权限验证：

打开插件管理界面
File → Settings → Plugins

2.卸载GitLab插件

3.重新拉取项目

系统将弹出标准认证窗口：

Username：输入GitLab用户名

Password：输入密码