Search

Git Push 시 파일 크기 제한 초과 오류 해결하기

fatal: the remote end hung up unexpectedly
Git에서 파일 크기 제한으로 인해 fatal: the remote end hung up unexpectedly 오류가 발생한 문제를 해결한 방법을 정리해보았습니다.

문제 상황

git push를 실행했을 때, fatal: the remote end hung up unexpectedly 오류가 발생했습니다. 이는 원격 저장소에서 허용하는 최대 파일 크기 또는 전체 push 크기 제한을 초과했기 때문에 발생한 오류였습니다.

해결 방법

이 문제를 해결하기 위해 Git의 http.postBuffer 설정을 변경하여 push 데이터를 압축하고 크기를 줄였습니다. 이 설정은 Git이 HTTP 프로토콜을 통해 데이터를 push할 때 사용하는 버퍼 크기를 조정해줍니다.
위 명령어를 실행하면 버퍼 크기가 500MB로 설정되어 push할 수 있는 데이터의 크기가 늘어나게 됩니다.
이 설정을 적용한 후, 다시 git push를 시도했을 때 오류 없이 성공적으로 원격 저장소에 데이터를 push할 수 있었습니다.

교훈

Git에서 대형 파일을 push할 때는 파일 크기 제한을 염두에 두고, 필요시 http.postBuffer 설정을 조정하여 문제를 해결할 수 있다는 점을 배웠습니다. 또한, 대형 파일을 자주 관리해야 한다면 Git LFS와 같은 도구를 사용하는 것이 장기적으로 더 좋은 방법일 수 있습니다.