[Git] 'fatal: refusing to merge unrelated histories' 오류 해결하기

발생한 문제

새로운 레포지토리를 생성하고 프로젝트를 올리려 했는데, 다음과 같은 오류가 발생했다. 

hint를 보아하니,, pull을 먼저 해주어야 한다고 한다. 

이를 따라 pull을 해주니

위와 같은 오류가 발생했다.

해석을 해보면,,, 히스토리가 서로 다른 프로젝트를 병합하려고 하여 문제가 발생하였다. 

 

주로 발생하는 경우로는

1. 로컬 저장소와 원격 저장소가 서로 다른 프로젝트이거나

2. 저장소를 처음 생성한 경우

라고 한다. 

 

나의 경우에는 원격 저장소와 로컬 저장소를 모두 새롭게 생성한 후 두 저장소를 연결하려 했을 때 발생하였다. 

 

해결

구글링을 통하여 쉽게 해결하였다. 

git pull origin 브런치명 --allow-unrelated-histories

먼저 위 커맨드를 작성해준다. 

서로 관련없는 프로젝트를 병합하는 것을 허용해주는 커맨드이다. 강제로 병합을 시도해주는 것 ...! 

 

병합을 시도했고, README 파일에서 충돌이 발생했다.

충돌을 해결해주고 커밋과 푸시를 다시 진행해주니 정상적으로 연결되었다.

 

원인

문제를 해결하고 나서야 원인을 찾을 수 있었다..

Vite로 만든 프로젝트의 README 와 원격 저장소의 기본 README의 충돌 때문이다. 

깃허브에서 원격 저장소를 생성할 때 README 파일을 추가하면 자동으로 커밋 이력이 생긴다. 

 

그러나 로컬 저장소에는 원격 저장소의 커밋 이력이 없기 때문에 이러한 오류가 발생한 것이다. 

VIte으로 프로젝트를 생성하여도 기본적으로 README를 작성해주고, README는 추후에 작성해도 되기 때문에....

앞으로 원격 저장소를 생성할 때 README는 생성하지 않는 방향으로 진행하려 한다.