Git Push 오류 - fatal : the remote end hung up unexpectedly

git push origin main

..
fatal : the remote end hung up unexpectedly

라고 안올라간다.

큰 파일이나 많은 양의 변경사항을 푸시할 때 발생할 수 있음. Git이 전송하는 데이터의 크기를 처리하지 못해서 연결이 끊기는 경우

 

 

이럴 땐 

http.postBuffer 설정 값을 늘려주면 됨

git config http.postBuffer 524288000

 

하고 다시 push하면 올라간다. 

 

Git의 HTTP 버퍼 크기를 500MB로 설정.
기본적으로 Git의 http.postBuffer 값은 1MB로 설정되어 있어서, 큰 파일을 푸시할 때 이 값이 부족하면 문제가 발생할 수 있음

 

---

 

변경된 값은 500MB이고,

기본값은 1MB로

git config http.postBuffer 1048576

으로 원복하면 된다.

 

 

확인은 

git config --get http.postBuffer

로 하면 됨

 

 

---

 

1. 왜 http.postBuffer 값을 늘려야 하나?
   • Git은 HTTP 프로토콜을 통해 데이터를 전송할 때, 기본적으로 1MB 크기의 버퍼를 사용해. 그러나 큰 파일이나 많은 변경사항이 있을 경우, 이 크기만으로는 데이터를 다 처리하지 못해 연결이 끊김.
   • 이를 해결하기 위해 버퍼 크기를 늘려서 더 큰 데이터를 전송할 수 있도록 하는 거야.
2. 푸시가 실패하는 이유
   • 네트워크 연결 문제나 HTTP 서버의 제한 때문에 데이터 전송이 중단될 수 있어.
   • 특히 큰 파일을 처리할 때, 기본 1MB 버퍼로는 데이터 전송이 충분히 빠르거나 안정적이지 않을 수 있어서 Git 서버가 연결을 끊어버리는 경우가 생겨.

주의사항

• 큰 값 설정의 부작용: http.postBuffer 값을 너무 크게 설정하면, 메모리 사용량이 증가할 수 있어. 이로 인해 메모리 부족 문제가 발생할 수 있으니, 필요에 맞게 적절한 값으로 설정하는 것이 좋아.
• 일반적으로 500MB 정도로 설정해도 대부분의 푸시 문제를 해결할 수 있지만, 너무 큰 파일을 푸시할 때는 Git LFS(Large File Storage) 같은 대형 파일 관리 도구를 고려하는 것이 더 좋을 수 있어.

---

결론적으로, fatal: the remote end hung up unexpectedly 오류는 큰 파일 푸시 시 버퍼 크기 부족 때문에 발생하는 경우가 많아. 이때 http.postBuffer 값을 늘려주면 문제를 해결할 수 있고, 필요할 때 전역 설정이나 로컬 설정을 적절히 사용하는 것이 좋아.