Composer提示Git权限拒绝，90%是凭证、协议或用户上下文问题：HTTPS需检查凭据管理器或git credential reject；SSH需验证ssh -T git@github.com且私钥权限为600；auth.json必须600权限并含repo权限Token，CI环境须确保用户一致。
Composer提示Git权限拒绝，90%不是Git本身坏了，而是它调用系统git命令时被操作系统拦下来了——真正卡住的环节在凭证、协议、用户上下文这三层，不是改个composer.json就能绕过去。
报“Could not read from remote repository”先看协议和认证链
这个错误只说明git clone失败，但Composer不负责认证，它只是把命令甩给系统git执行。你手动git clone能通，不代表Composer能复用同一套凭据。
- HTTPS仓库：检查
git credential reject后重输host=github.com和protocol=https，Windows看「凭据管理器」，macOS看「钥匙串访问」 - SSH仓库：必须跑
ssh -T git@github.com验证，失败就说明私钥没加载（ssh-add -l为空）、公钥没上传、或私钥权限不是600（chmod 600 ~/.ssh/id_rsa） - 别忽略
git config --global user.name和user.email——某些自建GitLab会校验这两项，缺了直接拒
auth.json文件权限和作用域容易被忽略
auth.json是Composer唯一认的凭据文件，但它有严格的加载规则和权限要求，配错位置或权限等于没配。
- 项目根目录的
auth.json会**完全覆盖**全局配置（~/.composer/auth.json），用composer config --list查实际生效路径 -
~/.composer/auth.json权限必须是600：chmod 600 ~/.composer/auth.json，否则Composer直接跳过该文件 - GitHub Token必须带
repo权限（不是public_repo），否则访问fork库或组织内私有库时静默失败 - CI环境里常见陷阱：用root执行
composer config --global，但runner以www-data用户运行——凭据对不上
API限流导致的“Permission denied”是假象
报错里带API rate limit exceeded，但你没动Token？那大概率是Composer在解析分支名（如dev-main）、拉取源码（--prefer-source）、或处理未收录到Packagist的包时，直连了https://api.github.com/——这个请求走的是GitHub API限流通道，和git clone完全无关。
- 验证方式：临时加
--prefer-dist再跑composer install，如果成功，就是API限流问题 - 解决办法：在
auth.json里填入带repo权限的GitHub Token，或换用SSH协议（绕过API） - 注意：Token不能写在
composer.json里，必须进auth.json，否则会被提交到Git
Git二进制不可用也会伪装成权限错误
报错里出现git was not found in your PATH或fatal: unable to access，但你确认装了Git？问题常出在环境隔离上。
- Web服务（如PHP-FPM）、Docker容器、CI runner通常以非登录用户（
www-data、gitlab-runner）运行，它们的PATH和你的交互式终端不同 - 新开一个纯净终端，执行
which git和composer diagnose，看是否仍有Git not found警告 - Docker中确保基础镜像已安装完整git：
RUN apt-get update && apt-get install -y git（Debian/Ubuntu）或RUN apk add --no-cache git（Alpine） - Windows下检查Git for Windows安装时是否勾选「Add Git to the system PATH」，并重启CMD/PowerShell
最麻烦的不是报错本身，而是它混在一堆“Failed to clone”“Could not write”里，让人分不清是凭证失效、API限流，还是Git根本没装。盯住报错里第一个明确路径或命令（比如ssh -T git@github.com失败，或curl https://api.github.com/...返回403），从那里切进去，别在composer.json里打转。
