[GitHub] github-readme-stats 오류 해결 - Vercel fork 배포 및 Deployment 캐시 문제

목차

📌 요약

GitHub 프로필을 꾸밀 때 자주 사용하는 github-readme-stats가 어느 순간 위와 같은 오류를 띄우며 더 이상 표시되지 않았다. 정확한 원인은 알 수 없지만, 기본 Vercel 배포 인스턴스가 트래픽 과부하 또는 GitHub API rate limit에 걸렸을 가능성이 높아 보인다.

따라서 본인 계정으로 fork하여 직접 Vercel에 배포하는 방식으로 해결하는 방법을 정리한다.

 

---

📌 1. GitHub Readme Stats 프로젝트 fork

공식 레포지토리: https://github.com/anuraghazra/github-readme-stats

GitHub - anuraghazra/github-readme-stats: :zap: Dynamically generated stats for your github readmes

이 오픈소스 프로젝트를 본인 계정으로 fork한다. 이후 Vercel에서 fork한 레포지토리를 선택해 배포한다.

 

Vercel: https://vercel.com

Vercel: Build and deploy the best web experiences with the AI Cloud - Vercel

fork한 레포지토리를 선택해서 추가하면 아래 사진처럼 Vercel에 GitHub Readme Stats 프로젝트가 생성된다.

📌 2. GitHub PAT 토큰 생성

Vercel에서 작업하기 전에 먼저 진행해야 할 것이 있다. 아래 사진처럼 GitHub에서 Setting > Developer Settings > Tokens (classic)을 클릭한다. 그리고 토글을 클릭해 Generate new token (classic)을 클릭한다.

 

Note에는 적절한 이름을 입력하고 유효기간도 적절히 설정한다. public 레포지토리에서 작업하기 때문에 권한은 사진처럼 public_repo와 read:user만 있으면 된다.

토큰이 생성되면 다시 확인할 수 없으므로 반드시 복사해둔다.

📌 3. Vercel 환경변수 추가

생성된 GitHub 토큰을 Vercel 환경변수에 추가해야 한다. 아래 사진처럼 Settings > Environment Variables로 이동한다.

 

Key는 PAT_1을, Value에는 GitHub 토큰을 입력하고 Save를 클릭한다.

3.1 환경변수를 추가해도 적용되지 않는 문제

이때, 환경변수를 저장한다고 즉시 반영되지는 않는다. 환경변수를 추가했는데 Readme Stats는 계속 아래처럼 토큰 미발견 오류를 출력한다.

 

환경변수를 추가하고 재배포를 여러 번 시도했지만 해결되지 않아 고생했고, 결론적으로 Deployment 캐시가 환경변수를 적용하지 않아 발생한 문제였다. 따라서 아래 단계를 반드시 수행해야 한다.

재배포만으로는 해결되지 않는다. 기존 Deployment를 직접 삭제한 뒤 새로 생성해야 최신 환경변수가 적용된다.

 

📌 4. 기존 Deployment 삭제

기존에 있는 Deployment를 Delete로 삭제한다. 여러 개의 Deployment가 생성되어 있었다면 모두 삭제한다. 최신 환경변수가 적용된 Deployment가 존재하지 않기 때문이다.

📌 5. 새 Deployment 생성

Deployment 목록을 모두 삭제했으면 Deployments에서 Create Deployment를 눌러 새로 생성한다. 새 Deployment는 최신 환경변수를 로드하게 된다.

📌 6. README 이미지 URL 변경

새로운 Deployment는 github-readme-stats-xxx.vercel.app 형식의 독립된 도메인을 부여받는다.

![Anurag's GitHub stats](https://github-readme-stats-xxx.vercel.app/api?username=username&theme=buefy&show_icons=true&hide_border=true)

 

리드미에서 기존의 github-readme-stats.vercel.app가 아니라 본인 프로젝트의 도메인으로 변경하면 다음과 같이 정상적으로 표시된다.

 

📌 2025.11.28 업데이트: 현재는 기존 코드도 다시 정상적으로 동작하는 것 같다.