Composer报403 Forbidden主因是GitHub认证缺失或Token权限不足，需配置github-oauth令牌并验证权限，而非简单换源；同时排除镜像源异常或限流问题。
Composer 报 403 Forbidden，基本不是网络不通，而是你被服务器“认出来且拒之门外”了——常见于 GitHub、GitLab 或私有仓库的认证缺失或 Token 权限不足。
确认是不是 GitHub 访问触发的 403
Composer 在拉取 GitHub 上的包（尤其是 dev- 分支、private 仓库或高频请求时）会直连 GitHub API。一旦超出未认证请求限额（60次/小时），或访问私有库但没配 Token，GitHub 就返回 403 Forbidden，而不是 401 Unauthorized。
- 运行
composer update -vvv，看错误是否出现在类似https://api.github.com/repos/xxx/yyy/zipball/...的 URL 上 - 用
curl -I -H "Accept: application/vnd.github.v3+json" https://api.github.com/rate_limit检查当前 IP 的剩余调用次数；若X-RateLimit-Remaining: 0，基本锁定是 GitHub 限流 - 如果是公司项目或 CI 环境，还要确认是否用了共享 IP（如 Jenkins 服务器出口 IP 被封）
配置 github-oauth 解决认证问题
这不是“换源”能绕开的问题，必须让 Composer 以你的身份访问 GitHub——靠 Personal Access Token。
- 去 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic)，勾选
repo和read:packages，生成后立即复制（关页即丢） - 执行：
composer config --global github-oauth.github.com（注意域名是github.com，不是api.github.com） - 验证：删掉
vendor/和composer.lock，再跑composer install；若不再报403，说明生效 - ⚠️ 切勿把 Token 提交到代码库，也别在 CI 脚本里硬编码；CI 中应通过
GITHUB_TOKEN环境变量注入
排除镜像源伪装成 403 的假象
有些国内镜像（比如已停用的 Laravel China 镜像）在上游不可达时，会反代返回 403 而非 404 或 502，造成误判。
- 先查当前源：
composer config --list | grep repo.packagist - 临时切回官方源验证：
composer config -g repo.packagist composer https://repo.packagist.org - 如果切完就正常，说明原镜像异常；推荐稳定替代：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 特别注意：Laravel China 镜像（
packagist.laravel-china.org）已于 2023 年底下线，仍在用它必出错
真正难排查的，往往是 403 和 404 混在一起——比如镜像源返回了 403（因同步失败），而你却去检查 GitHub Token；或者 Token 配了但权限不够（漏了 repo），结果反复重试都卡在同一个错误上。动手前，先用 -vvv 看清具体哪个 URL 被拒，比盲目清缓存或换源更省时间。
