配置gitHub Personal access Token可解决composer的rate limit问题,通过提升api调用限额至每小时5000次,避免因未认证请求导致的频率限制错误。

当使用 Composer 安装或更新依赖时,如果频繁访问 github 的公开 API,可能会遇到 “rate limit exceeded” 错误。这是因为 GitHub 对未认证的请求有每小时 60 次的限制。Composer 在拉取包信息时会调用 GitHub API,超出限额后就会失败。
使用 GitHub Personal Access Token
最有效的解决方法是配置一个 GitHub Personal Access Token(PAT),让 Composer 以认证用户身份访问 API,将请求限额提升至每小时 5000 次。
操作步骤:
- 登录 GitHub,进入 Settings → Developer settings → Personal access tokens → Tokens (classic)
 - 点击 Generate new token (classic)
 - 勾选 repo 和 read:packages 权限即可
 - 生成后复制 token 字符串
 - 在终端运行以下命令,将 token 添加到 Composer 配置中:
 
composer config –global github-oauth.github.com YOUR-TOKEN-HERE
这会在全局 Composer 配置文件(通常是 ~/.composer/config.JSon)中添加 GitHub 认证信息。
检查并清除缓存(可选)
如果之前请求已触发限流,可以清除 Composer 缓存,避免重试旧的失败请求:
composer clear-cache
然后再重新执行安装或更新命令。
使用镜像或私有仓库(高级方案)
在团队开发或 CI/CD 环境中,可考虑:
- 搭建私有包镜像(如 Satis 或 private Packagist)
 - 使用国内镜像源(如阿里云 Composer 镜像)减少对 GitHub 的直接调用
 - 在 CI 中缓存 vendor 目录和 Composer 缓存目录
 
基本上就这些。只要配置了 GitHub Token,绝大多数 “rate limit exceeded” 问题都能立即解决。记得不要把 token 写在项目配置中,应通过全局配置或环境变量安全管理。


