答案是配置访问令牌或使用SSH认证。首先为GitHub/GitLab生成Personal Access Token并配置Composer全局设置，或在composer.json中通过SSH协议指定仓库地址并确保公钥已添加，同时检查全局与项目级配置冲突，必要时使用HTTPS嵌入Token方式适用于CI/CD环境，确保凭证有效且权限充足。
Composer 访问私有仓库（如 GitLab 或 GitHub）时认证失败，通常是因为缺少有效的身份凭证。这类问题不能仅靠配置仓库地址解决，必须确保 Composer 能正确通过认证拉取代码。以下是常见原因和解决方案。
1. 为私有仓库配置访问令牌（Personal Access Token）
GitHub 和 GitLab 都要求使用个人访问令牌（PAT）代替密码进行认证，尤其是在启用了双因素验证或已弃用密码登录的情况下。
操作步骤：
- 前往 GitHub / GitLab 设置页面生成 Personal Access Token
- 确保 token 拥有访问私有仓库的权限（如 repo 权限）
- 在本地运行以下命令将 token 添加到 Composer 配置中：
composer config --global github-oauth.github.com YOUR_GITHUB_TOKEN
对于 GitLab：
composer config --global gitlab-token.gitlab.com YOUR_GITLAB_TOKEN
替换为你实际使用的 GitLab 域名（如自建实例）。
2. 在 composer.json 中指定仓库并使用 SSH 协议
如果不想依赖 token，可以改用 SSH 认证方式，前提是已在对应平台添加了 SSH 公钥。
修改 composer.json：
"repositories": [
{
"type": "vcs",
"url": "git@gitlab.com:username/private-package.git"
}
]
确保使用 git@... 格式的 SSH 地址，并确认本地 SSH 可正常连接：
ssh -T git@gitlab.com 或 ssh -T git@github.com
若提示权限拒绝，请检查 ~/.ssh/id_rsa 是否存在，公钥是否已添加到 Git 平台账户。
简单易用的 GitCode API SKILL，提供 CLI 和轻量级 Python SDK 两种调用方式，用于与 GitCode 的 REST API 进行交互。支持加密访问令牌、异步调用以及完善的类型提示。 - 文档：https://gitcode-api.readthedocs.io/ - PyPI 页面：https://pypi.org/project/gitcode-api - GitHub 仓库：https://github.com/Trenza1ore/GitCode-API
3. 检查全局配置与项目级配置冲突
有时全局配置的 token 无效，而项目未单独设置，会导致拉取失败。
查看当前配置：
composer config --list --global
删除无效配置：
composer config --global --unset github-oauth.github.com
然后重新设置正确的 token，或在项目目录下执行不带 --global 的命令，仅作用于当前项目。
4. 使用 HTTPS + 用户名 + Token 方式（适用于 CI/CD）
在自动化环境中，可直接在 URL 中嵌入 token：
"url": "https://oauth2:YOUR_TOKEN@gitlab.com/username/private-repo.git"
GitHub 类似：
"url": "https://x-access-token:YOUR_TOKEN@github.com/username/private-repo.git"
这种方式适合部署脚本，避免依赖全局配置。
基本上就这些。关键点是：Composer 必须能通过 token 或 SSH 完成认证，且权限足够。只要凭证有效、协议正确，私有仓库访问就不会失败。
