Vercel 배포 로그에 오류가 표시돼요
Vercel 배포 과정에서 표시된 원문 오류 메시지를 기준으로, 이미 확인된 오류 문서로 이동하는 가이드입니다.
빠른 답변
Vercel 배포가 실패하면 로그의 오류 메시지 전체와 배포 URL을 먼저 기록한 뒤, 같은 원문 메시지를 다루는 문서를 확인해야 합니다. 이 가이드만 보고 빌드 설정이나 배포 환경 변수를 변경하지 마세요.
이 가이드가 맞는 경우
- 애플리케이션 오류 메시지
- 빌드 성공, 배포 실패
상황별 다음 단계
Cannot load project settings
Vercel 배포 로그에 Cannot load project settings가 표시됩니다.
Command not found in vercel dev
Vercel CLI 로그에 Command not found in vercel dev가 표시됩니다.
Failed to install builder dependencies
배포 로그에 Failed to install builder dependencies가 표시됩니다.
GitHub app installation not found
연결 과정에서 GitHub app installation not found가 표시됩니다.
Invalid Edge Config connection string
배포 설정 또는 로그에 Invalid Edge Config connection string이 표시됩니다.
Invalid route destination segment
라우트 설정 검사에서 Invalid route destination segment가 표시됩니다.
Invalid route source pattern
라우트 설정 검사에서 Invalid route source pattern이 표시됩니다.
Missing build script
빌드 로그에 Missing build script가 표시됩니다.
Missing public directory
배포 로그에 Missing public directory가 표시됩니다.
Production deployment cannot be redeployed
재배포 과정에서 Production deployment cannot be redeployed가 표시됩니다.
SSL certificate deletion denied
인증서 삭제 과정에서 SSL certificate deletion denied가 표시됩니다.
Yarn dynamic require of "util" is not supported
빌드 로그에 Yarn dynamic require of util is not supported가 표시됩니다.
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 배포 URL, 배포 시각, 실패한 단계와 오류 메시지 전체를 전달합니다.
- 사용한 Git 커밋 SHA와 변경된 설정 파일 목록을 전달합니다.
- 빌드 명령, 패키지 관리자, Node.js 버전을 함께 전달합니다.
알아둘 점
Vercel의 오류 문구는 배포 설정, 빌드 과정, 연결된 서비스처럼 서로 다른 단계에서 나타납니다. 오류 문구 전체와 실패 단계를 먼저 기록한 뒤, 위에서 같은 원문을 선택하세요.
같은 배포를 여러 번 다시 실행하거나 설정을 한꺼번에 바꾸면 원인을 구분하기 어려울 수 있습니다. 변경 전에는 현재 설정 파일과 배포 로그를 보관하세요.
먼저 기록할 것
- 배포 URL과 실패한 시각을 기록합니다.
- 첫 오류 메시지부터 실패 종료까지의 로그를 보관합니다.
- 배포에 사용한 Git 커밋 SHA, 빌드 명령, Node.js 버전을 기록합니다.
오류 문구가 위 분기와 정확히 일치하지 않으면, 이 가이드에서 원인을 추정하지 마세요. 로그 원문과 현재 배포 설정을 개발 담당자에게 전달한 뒤 공식 Vercel 오류 목록에서 같은 문구를 확인하세요.
참고 자료
Vercel · 공식 자료 · 확인 범위: guide-branch-vercel-deployment-error-messages · 확인일: 2026-07-25