向GitHub README添加Stats时出现错误,如何解决?
我之前折腾GitHub Readme Stats的时候也踩过这个一模一样的坑,给你梳理下精准的解决步骤:
核心问题拆解
你看到的错误提示 Maximum retries exceeded Please add an env variable called PAT_1 with your github token in vercel 已经把问题说透了:你在Vercel上部署的服务缺少GitHub个人访问令牌(PAT)的环境变量,导致请求GitHub API时被限流或者权限不足,重试多次后直接失败。
一步步解决问题
生成符合要求的GitHub PAT
登录你的GitHub账号,依次进入「Settings」→「Developer settings」→「Personal access tokens」→「Tokens (classic)」,点击「Generate new token」。
必须勾选的权限:repo(如果需要统计私有仓库数据)、read:user(获取你的用户基础信息)。生成后立刻复制这个令牌,关闭页面后就再也看不到了,一定要存好。给Vercel部署实例添加
PAT_1环境变量- 打开Vercel控制台,找到你部署的github-readme-stats项目。
- 进入「Settings」→「Environment Variables」页面。
- 点击「Add」按钮,变量名严格填
PAT_1,变量值粘贴刚才生成的GitHub PAT,然后点击「Save」。 - 回到「Deployments」页面,找到当前的部署记录,点击「Redeploy」,选择「Redeploy with existing settings」,确保新的环境变量能生效。
检查Profile里的图片链接
确认你GitHub Profile的README里引用的Stats图片链接,是指向你自己Vercel部署的域名,而不是官方的默认链接。比如应该是https://你的Vercel项目域名.vercel.app/api?username=你的GitHub用户名,别用官方的公共域名。额外排查小细节
- 用户名大小写:虽然GitHub API对用户名大小写不敏感,但保险起见,链接里的用户名和你GitHub账号的实际用户名要完全一致(包括大小写)。
- 令牌权限:如果还是报错,检查PAT的权限有没有选对,要是只需要统计公开仓库,选public_repo权限也可以。
- Vercel部署日志:去Vercel的部署日志里看看有没有其他错误,比如依赖安装失败这类问题。
验证是否解决
部署完成后,直接在浏览器里打开你的Stats图片链接,如果能正常显示统计图表,再刷新你的GitHub Profile页面,应该就能看到正常的Stats模块了。
内容的提问来源于stack exchange,提问作者user20759768

