[TIL, 일일 회고] 2024.09.27 - Git: 'fatal: couldn't find remote ref' 오류 해결하기

 

문제 상황

 

새로운 프로젝트를 시작하면서 프로젝트를 클론 후 확인차 "git pull origin dev"로 원격 저장소에서 로컬 저장소로 가져오려고 했습니다.

fatal: couldn't find remote ref dev

 

그러나 위 그림에서 알 수 있듯이 fatal에러가 발생했습니다. 

 

fatal: couldn't find remote ref dev 오류는 Git에서 dev라는 브랜치가 원격 저장소에 존재하지 않을 때 발생하는 에러입니다.

 

 

위 사진은 깃허브의 브랜치목록입니다. 사진에서 알 수 있듯이 dev와 main이라는 브랜치가 존재함에도 로컬에서 dev 브랜치를 찾을 수 없었습니다.

 

문제 해결

처음에는 dev 브랜치를 원격에서 fetch하고 checkout하면 문제가 해결될 것이라고 생각했으나, 여전히 동일한 에러가 발생했습니다.

원격 저장소에 main과 dev라는 브랜치가 있음에도 불구하고 로컬에서는 원격 저장소에 dev라는 브랜치를 찾을 수 없다.

 

문제를 다시한번 보고 생각해보면 위와 같이 정리할 수 있습니다.

 

따라서 "git remote -v" 명령어로 현재 로컬 저장소에 설정된 원격 저장소 목록과 해당 URL을 확인해본 결과 다른 프로젝트에 연결되어 있었습니다.

 

보통은 clone 후 자동으로 remote에 연결되지만 어떠한 이유인지 모르겠지만 연결이 안된 것으로 보입니다.

 

1. origin 정보 확인

git remote -v

 

2. 현재 리모트 삭제

git remote remove origin

 

3. 새로운 origin 추가

git remote add origin https://github.com/프로젝트.git

 

이 과정을 통해 원격 저장소가 올바르게 연결되었고, 이후 git pull origin dev 명령어로 dev 브랜치를 정상적으로 가져올 수 있었습니다.

 

 

---

 

문제를 해결하고 나서 다시 생각해보니, 로컬 저장소에 연결된 원격 저장소에는 main과 feat/review 브랜치만 있었고, 실제 원격 저장소에는 main과 dev 브랜치가 있었기 때문에 로컬에서 잘못된 원격 저장소(origin)를 바라보고 있었던 것이 분명했습니다..