首先检查并更新认证令牌，确保使用有效的 Personal access Token 或用户名/密码；接着清除 composer 缓存及 auth.json 中的错误凭据；然后确认 composer.json 中私有仓库 URL 配置正确且权限匹配；最后通过浏览器登录、curl 测试或 composer update -vvv 验证连接与权限。

遇到 Composer 提示 “Invalid credentials for…” 认证失败时，通常是因为访问私有仓库（如 gitLab、github、Packagist 私有包或企业镜像）需要身份验证，但当前凭据不正确或已过期。以下是常见解决方法：

检查并更新认证令牌

Composer 一般使用 API token 或用户名/密码进行认证。确认你使用的令牌是否有效：

• 前往对应平台（如 GitHub、gitlab）生成新的 Personal Access Token（确保包含 repo 权限）
• 在命令行中重新执行 composer config –global http-basic.domain.com username token（适用于 HTTP 基本身份验证）
• 对于 OAuth 认证，使用 composer config –global github-oauth.github.com your-new-token

清除缓存的错误凭据

Composer 可能缓存了旧的或错误的登录信息：

轻舟办公

基于AI的智能办公平台

194

查看详情

• 运行 composer clear-cache 清除全局缓存
• 检查项目根目录下的 auth.json 文件（或全局配置），删除无效条目
• 全局配置路径一般为 ~/.config/composer/auth.json（linux/macos）或 C:UsersYourNameappDataRoamingComposerauth.json（windows）

确认仓库配置正确

确保 composer.json 中定义的私有仓库地址和域名拼写无误：

• 检查 repositories 字段中的 URL 是否使用 https
• 某些平台要求开启 2FA 后必须用 token 登录，不能用密码
• 企业版服务（如 GitLab CE/EE）需确认 Composer 使用的域名与实际一致（例如：gitlab.company.com）

测试连接是否正常

手动测试能否访问目标资源：

• 用浏览器登录对应平台，确认账号状态正常
• 尝试用 curl 测试：curl -H “Authorization: Bearer your-token” https://domain.com/api/v4/projects
• 运行 composer update -vvv 查看详细错误日志，定位具体哪一步失败

基本上就这些。关键是确保 token 有效、配置位置正确，并清除残留的错误凭据。