본문 바로가기
💻 프로젝트/🐰토끼와 거북이 경주게임🐢

[Vue, VITE] Vercel로 서버 배포할 때 에러가 발생했다면 branch 확인해보기

by hyeong._.ing 2026. 5. 27.

 

 

Vue로 만든 간단한 게임인
토끼와 거북이 경주 게임을 서버에 배포하고자 했다.
그런데 자꾸 오류가 발생하면서 배포가 멈췄다.
왜 그런지 찾아보고 해결해보자.

 

 

 

 

1. 원인파악

  • 오류 메시지
Deployment failed with error.

Running build in Washington, D.C., USA (East) – iad1
Build machine configuration: 2 cores, 8 GB
Cloning github.com/hyeong-ing/RabbitAndTurtleGame (Branch: main, Commit: 605a739)
Previous build caches not available.
Cloning completed: 195.000ms
Running "vercel build"
Vercel CLI 54.4.1

 

맨 윗줄의 failed가 없었으면 아래 내용은 별 문제 없는 내용이다. 실제로 아래 내용은 그냥 빌드 시작했다는 내용이다.
그런데 왜  Deployment failed with error가 발생한걸까? 여기서 보면 Branch가 main으로 되어있다. 내 Git에 있는 branch를 한 번 살펴볼 필요가 있다.

 

 

  • Git 확인하기

main은 README.md만 가지고 있고 실제 코드는 하나도 없다. 그래서 Vercel이 배포에 실패한 것이다. 그럼 branch를 열어서 보자. 아마 다른 branch가 있을 것이다. 나의 경우 main이 아닌 master에 코드가 존재했다. (예전에 만들어서 기억이 하나도 안났다)

이제 원인을 파악했다. Vercel에서 프로젝트의 branch를 main을 master로 옮기면 될 것이다. 

 

 

 

 


 

 

 

 

2. 실패한 해결방법

혹시라도 이걸 보시는 분 환경에선 되실수도 있어서 적어봅니다.

  • Vercel에서 branch 바꾸기

왼쪽바에서 하단으로 내리면 Settings가 있다. 

여기서 Environments를 들어간다.

production이 보일거다. 그걸 누르면 위의 이미지와 같은 모습이 보인다. 여기서 main을 master로 바꾼뒤 deploy를 누르면 된다. 그런데,,, 난 안됐다. 내가 무언갈 잘못한걸지도 모르지만 계속 실패해서 포기하고 다른 방법을 찾았다.

 

 

  • 터미널에서 master 코드를 main으로 push하기
cd 프로젝트가 있는 경로 (예: cd /WebstormProjects/rabbitandturtle)
git checkout master
git push origin master:main
Username for 'https://github.com':
Password for 'https://hyeong-ing@github.com':
git push origin master:main을 입력하면 Username과 Password를 적으라고 시킨다. 하란대로 하면 된다.

 

remote: Invalid username or token. Password authentication is not supported for Git operations.
fatal: Authentication failed for...어쩌고
하란대로 해도 안됐다. 대충 Git이 패스워드 인증방식을 지원하지 않는다는 내용 같다. 그리고 유저 이름 혹은 토큰이 유효하지 않는다고 한다. 뭐 여기서 해결하는 방법이 더 있는 것 같긴한데, 더 쉽고 간단한 방법이 생각났다.

 

 

 


 

 

 

 

3. 해결방법

  • 프로젝트의 default branch 바꾸기

Vercel에서 배포하려던 프로젝트에 들어가자. 왼쪽 바, 하단에서 Settings를 찾고 General을 누르자.

 

그리고 프로젝트를 삭제하면 된다.

 

이제 GitHub에 들어간다. 그리고 배포할 프로젝트 내에 있는 Settings를 누르자.

 

그러면 맨 첫번째에 General이 있다. 그걸 누르고 옆을 보면 Default branch를 지정할 수 있다. master branch에 코드가 있으니 main에서 master로 옮겼다.

 

이제 다시 배포 과정을 반복하면 된다. Add New에서 Project를 누르고

 

import하면 된다. 일단 이렇게 해서 해결하긴 했는데, 이 방법이 좋은건진 나도 모른다! 하하... 결과적으로 배포만 되면 좋은거겠지 하는 마인드로 진행했다.