Composer“Could not read from remote repository”错误主因是SSH认证失败或GitHub OAuth凭证未配置，需验证ssh -T连接、检查私钥加载与权限，并为HTTPS仓库配置github-oauth token。
不是密码错了，也不是网络不通，而是 Composer 根本没把你的凭证传给 GitHub/GitLab——它卡在认证环节，连远程仓库的门都没摸到。
报错时先盯住终端里那行 git clone 或 Could not read from remote repository
这类错误 90% 出现在用 git@ 地址拉私有仓库时。Composer 调用的是系统 git 命令，而 git 是否能连上，完全取决于你本地 SSH 配置是否生效。
- 运行
ssh -T git@github.com（或对应平台如git@gitlab.com），看到Hi xxx! You've successfully authenticated才算通 - 如果提示
Permission denied (publickey)，说明密钥没加载或没加对——检查~/.ssh/id_rsa.pub是否已贴到平台的 SSH Keys 设置页 - 别信
git clone git@...成功就代表 Composer 没问题：Composer 有时会绕过 shell 的ssh-agent，得单独测试git -c core.sshCommand="ssh -i ~/.ssh/id_rsa" ls-remote git@github.com:org/repo.git
HTTPS 私有仓库必须配 github-oauth，且 Token 权限要够
GitHub 已禁用密码登录，https://github.com/org/private-repo.git 这种写法必须靠 Token 认证，否则 composer install 会在下载时静默失败或卡住。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 生成 Token 时至少勾选
repo（读写私有库）、read:packages（如果用了 GitHub Packages） - 执行
composer config --global github-oauth.github.com <your-token>，Token 会存进~/.composer/config.json，别手写进composer.json - 确认
composer.json里仓库定义是标准 HTTPS 格式："url": "https://github.com/username/repo.git"，且"type": "vcs" - 如果用的是 GitLab 或自建 Gitea，对应配置项是
gitlab-oauth或gitlab-token，不是通用的github-oauth
vendor 目录权限正常，但 composer.lock 写不进去？查清楚是谁在拦
有些报错看着像远程权限问题，实际是本地目录归属被污染了。比如 file_put_contents(/path/to/composer.lock): Permission denied，这跟 GitHub 一毛钱关系都没有。
- 立刻执行
ls -ld composer.lock和ls -ld vendor/，只要任意一行显示root root，就是之前误用sudo composer install留下的坑 - 修复命令只有一句：
sudo chown -R $USER:$USER composer.lock vendor/，别碰chmod -R 777 - 如果
composer install卡在Writing lock file，大概率是composer.lock归属不对，不是远程仓库问题
CI/CD 流水线里拉私有库失败？别硬塞密码，用部署密钥或 OIDC
本地能跑不等于 CI 能跑。GitHub Actions、GitLab CI 默认没加载你的 SSH 密钥，也没读取你的全局 github-oauth 配置。
- GitHub Actions 推荐用
actions/checkout@v4+GITHUB_TOKEN（自动注入，有 repo 权限），再配composer config --global github-oauth.github.com ${{ secrets.GITHUB_TOKEN }} - GitLab CI 用
SSH_PRIVATE_KEY变量注入密钥，再在before_script里mkdir -p ~/.ssh && echo "$SSH_PRIVATE_KEY" > ~/.ssh/id_rsa && chmod 600 ~/.ssh/id_rsa - 别把 Token 明文写进
.gitlab-ci.yml或提交到代码库——所有凭证必须走 secret 机制
最常被忽略的一点：私有仓库的 composer.json 里如果写了 "type": "package" 或手动指定了 "dist"，Composer 就不会走 VCS 克隆流程，也就压根不触发 SSH 或 OAuth 认证——它会直接去下载那个 dist URL，而那个 URL 往往是 404 或 403。先确认你依赖的包类型是否真需要 VCS 模式。
