[Git] GitHub 502 오류 해결 방법 (Git Push 오류)

오늘 GitHub에 코드를 푸시하는 과정에서 fatal: unable to access 'https://github.com/...': The requested URL returned error: 502 오류를 경험했습니다. 이 글에서는 해당 오류의 원인과 해결 과정을 공유합니다.

---

오류 상황: 터미널에서 아래와 같은 명령어를 실행했습니다:

git add .
git commit -m "250201 feat: ~~~~"
git push origin main

하지만 다음과 같은 오류 메시지가 나타났습니다:

fatal: unable to access 'https://github.com/mk-isos/JavaStudy.git/': The requested URL returned error: 502

---

오류 원인: 502 오류(Bad Gateway)는 일반적으로 서버의 일시적 문제로 인해 발생합니다. 특히, GitHub 서버에서 발생할 경우에는 서버 장애가 원인일 가능성이 큽니다.

오류가 발생한 후, GitHub Status 페이지를 확인한 결과 Git Operations에서 장애(Incident)가 발생한 것을 확인했습니다.

---

해결 방법:

1. GitHub 상태 페이지 확인:
   • GitHub Status에 접속하여 Git Operations 상태를 확인합니다.
2. 잠시 대기:
   • 서버 장애가 발생한 경우, GitHub가 이를 복구할 때까지 기다리는 것이 최선입니다.
3. 다시 시도:
   • 잠시 후 git push origin main 명령을 다시 실행합니다.
4. SSH로 전환 (옵션):
   • HTTPS 대신 SSH를 사용하여 푸시를 시도할 수도 있습니다. SSH 전환 방법:

git remote set-url origin git@github.com:mk-isos/JavaStudy.git
git push origin main

• SSH 키를 미리 생성하고 GitHub에 등록해야 합니다.

SSH 전환 방법을 다루는 글은 아래 글을 참고해주세요! 

https://mkisos.tistory.com/entry/Git-SSH-%EC%A0%84%ED%99%98-%EB%B0%A9%EB%B2%95GitHub-502-%EC%98%A4%EB%A5%98

 

---

결론: 502 오류는 대체로 GitHub 서버의 일시적인 장애로 인해 발생하며, 서버 복구 후 재시도하면 문제가 해결됩니다. 만약 동일한 문제가 장기적으로 발생한다면, Git 버전 업데이트나 SSH 방식 사용을 고려해볼 수 있습니다.

 

저는 서버 복구 기다리기 싫고 바로 푸시하고 싶어서 설정 후 푸시했어요!
(설정끝나고 몇분 지나니 바로 복구가 되더라구요.)