Composer无法拉取私有GitLab仓库依赖，提示输入密码如何解决？

你之前配置的http-basic、gitlab-token、gitlab-domains均是针对HTTP/HTTPS协议的Git仓库访问规则，而你composer.json中使用的是SSH协议的仓库地址，因此上述配置不生效属于正常现象，按以下步骤排查即可： #

1. 定位SSH身份验证异常点 #

先手动模拟Composer调用Git时的SSH日志输出，确认密钥加载是否正常：

• 先测试Git本身的SSH调用日志：

GIT_SSH_COMMAND="ssh -vvv" git clone git@git.my_gitlab_domain.com:my/project.git /tmp/test_composer_repo

如果上述命令无需密码正常拉取，再执行带日志的Composer安装命令，查看Composer调用Git时的SSH环节是否加载了正确的私钥：

COMPOSER_PROCESS_TIMEOUT=600 GIT_SSH_COMMAND="ssh -vvv" composer install -vvv

重点看日志中SSH尝试的身份文件路径，是否匹配你配置了GitLab访问权限的私钥。 #

2. 检查Git全局URL替换规则 #

Git的insteadOf配置会强制替换仓库访问地址，是这类问题的高发原因：

• 执行命令查看所有Git配置项：

git config --list

查找是否存在url.*.insteadOf相关规则，比如url.https://git.my_gitlab_domain.com/.insteadOf git@git.my_gitlab_domain.com:这类规则会强制把SSH地址转为HTTPS访问，导致SSH密钥失效。
如果存在错误的替换规则，执行删除即可：

git config --global --unset 对应规则的key

3. 清空Composer残留缓存 #

Composer会缓存仓库的历史访问信息，旧缓存可能导致地址规则不更新：

# 清空全局Composer缓存
composer clear-cache
# 手动删除对应仓库的缓存目录
rm -rf ~/.composer/cache/repo/git@git.my_gitlab_domain.com:my/project.git/

清理完成后重新执行composer install测试。 #

4. 修复SSH配置（密钥非默认路径场景） #

如果你使用的不是~/.ssh/id_rsa默认命名的私钥，需要在SSH配置中指定对应域名的私钥路径：

• 编辑~/.ssh/config文件，添加如下配置：

Host git.my_gitlab_domain.com
    User git
    IdentityFile ~/.ssh/你的私钥文件名
    IdentitiesOnly yes

• 同时保证私钥文件权限正确：

chmod 600 ~/.ssh/你的私钥文件名

快速替代方案 #

如果不想排查SSH问题，可以直接修改composer.json中的仓库配置，改用GitLab类型的HTTPS地址，即可复用你之前配置的GitLab令牌：

"repositories": [
    {
        "type": "gitlab",
        "url": "https://git.my_gitlab_domain.com/my/project.git"
    }
]

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