[Git] fatal: refusing to merge unrelated histories

😵 에러 상황

: 인텔리제이에서 생성한 프로젝트 파일을 깃허브와 연동해 파일을 push하려고 했다. (참고 사이트 : 링크)

IntelliJ에서 Terminal 창에 git pull origin main을 쳤는데 다음과 같은 에러가 났다.

https://github.com/[ID]/[파일명] * branch main -> FETCH_HEAD fatal: refusing to merge unrelated histories

 

서로 다른 두 브랜치의 커밋 히스토리를 병합하려고 할 때,

원격 저장소의 main 브랜치와 로컬 브랜치 간 공통된 커밋이 없을 때 주로 발생한다고 한다.

 

아마 깃허브에서 프로젝트 만들면서 미리 README.md 파일을 만들어 놓았는데,

인텔리제이에서 README.md 파일을 생성하는 명령어를 또 입력했기 때문인 것 같다.

 

 

🧐 해결 방법

두 브랜치를 강제로 병합해야 한다!

 

1. 'git pull origin main --allow-unrelated-histories'

- 원격 저장소의 main 브랜치의 변경 사항을 가져온다.

- --allow-unrelated-histories : 서로 다른 브랜치의 커밋 히스토리 허용

 

2. 커밋 히스토리가 병합된 후, 로컬 브랜치와 원격 저장소 간 충돌이 있는지 확인하고 해결한다.

 

3. 충돌 해결 후 커밋하고, 'git push origin main' 을 통해 변경사항을 원격 저장소로 push한다.

 

 

😇 결과

: "fatal: refusing to merge unrelated histories" 에러를 해결하고,

두 브랜치의 커밋 히스토리가 병합되었으며,

IntelliJ 프로젝트 파일이 원하던 깃허브 폴더에 잘 push되었다!

 

좌 : Before / 우 : After