GitHub 푸시 후 Vercel 배포가 Blocked가 되었을 때

Vercel Deployments 목록에는 Error, Ready, Blocked 같은 상태가 함께 보인다. Error는 빌드가 돌다가 실패한 경우가 많지만, Blocked는 빌드 자체가 정책상 진행되지 않은 상태일 수 있다.

이 상황에서는 로그를 아무리 봐도 코드 에러가 안 나올 수 있다. 배포가 시작되지 않았기 때문이다.

먼저 같은 브랜치의 다른 배포가 Ready인지 확인했다. 이전 배포가 정상이라면 코드 전체가 깨진 것은 아닐 수 있다.

그다음 GitHub 커밋 작성자와 Vercel 프로젝트가 인식하는 계정/권한을 확인했다. 프로젝트에 연결된 GitHub 사용자와 커밋 작성자가 다르게 잡히면 자동 배포가 제한될 수 있다.

해결은 새 커밋을 올려 Vercel이 프로젝트 권한 안에서 정상적으로 인식하는 작성자로 배포를 다시 시작하게 하는 쪽으로 진행했다.

배포 목록에서 빨간색 상태가 보인다고 바로 코드를 고치지는 않기로 했다. Error인지 Blocked인지 먼저 구분하고, Error라면 빌드 로그를, Blocked라면 권한과 Git 연동 상태를 본다.

작은 차이지만 이 순서를 지키면 불필요한 코드 수정이나 재배포를 줄일 수 있다.