从私有GitLab包仓库下载Composer包时提示凭证无效

问题根源 #

1. GitLab Pages私有仓库的访问依赖HTTP Basic认证，你当前配置的gitlab-token是用于GitLab API或Git仓库操作的，不适用于Pages静态资源的访问。
2. 你填写的仓库URL错误：GitLab Pages的访问地址不是项目主页https://gitlab.com/vendor/group/project，而是专属的Pages域名格式。

具体解决步骤 #

1. 修正Composer仓库URL

找到你的GitLab Pages实际访问地址（可在项目的「Pages」设置页查看），格式通常为：
https://<group-or-username>.gitlab.io/<project-name>

更新composer.json的repositories配置：

"repositories": [
    {
        "type": "composer",
        "url": "https://vendor-group.gitlab.io/project"
    }
]

替换vendor-group.gitlab.io/project为你的实际Pages地址

2. 配置HTTP Basic认证凭证

使用Composer命令添加针对Pages域名的HTTP Basic认证，用户名填你的GitLab账号名，密码用你的个人访问令牌（PAT，需包含read_repository或api权限）：

composer config http-basic.vendor-group.gitlab.io your-gitlab-username glpat-123456789abcdefgh

替换vendor-group.gitlab.io、your-gitlab-username和令牌内容为实际值

执行后auth.json会自动生成如下配置：

{
    "http-basic": {
        "vendor-group.gitlab.io": {
            "username": "your-gitlab-username",
            "password": "glpat-123456789abcdefgh"
        }
    }
}

3. 验证访问

执行composer require或composer update，即可正常拉取私有Satis仓库中的包。

额外排查点 #

• 确认个人访问令牌（PAT）已开启read_repository或api权限，否则无法访问私有Pages资源。
• 确认你的GitLab账号属于该Pages项目的成员列表，且项目Pages权限设置为「仅项目成员」。
• 可通过curl测试凭证有效性：

  curl -u your-gitlab-username:glpat-123456789abcdefgh https://vendor-group.gitlab.io/project/packages.json
  

  若返回合法的JSON数据，说明凭证和地址均正确。

内容的提问来源于stack exchange，提问作者fudo