로컬 폴더를 git을 사용하여 github에 올리던중
error: failed to push some refs to 'repo 주소'
와 같은 오류를 겪었다.
이를 해결하기 위해 인터넷 서칭과 Claud를 사용하여 해결하였다.
(1) 발생 원인
해당 오류는 주로 branch이름이 master로 설정되어 있어서 발생한다.
GitHub에서는 main이라는 branch이름을 사용하는데 내 컴퓨터에서는 master를 쓰고 있어서 나는 오류인것이다.
(2) 해결 방법
이를 해결하기 위해
git branch -m master main
git push origin main
master로 설정되어 있던 이름을 main으로 수정하고 다시 push 해주었더니 정상적으로 push 되었다.

(2-1) 재발 방지 방법
git config --global init.defaultBranch main
해당 코드를 사용하면 앞으로 Branch의 기본값이 master가 아니라 main으로 수정되어 같은 오류를 줄일 수 있다.
(3) 마무리
처음엔 error 메시지가 떠서 당황했지만 디버깅을 통해서 쉽게 해결할 수 있었다.
이후에 생기는 error도 메시지를 통해 해결해야겠다.
'Error' 카테고리의 다른 글
| [SQL] Unkown column (0) | 2026.03.28 |
|---|---|
| [Python] IndentationError & AttributeError 해결 과정 정리 (들여쓰기와 append 오류) (0) | 2026.02.26 |