Git 에러: POST git-receive-pack (chunked), send-pack: unexpected disconnect while reading sideband packet, fatal: the remote end hung up unexpectedly, Everything up-to-date

문제 상황

일반 코드만 푸시할 때는 아무 문제가 없었는데,

용량이 큰 PNG 또는 SVG 파일을 함께 푸시하자 다음과 같은 에러가 발생하였습니다.

POST git-receive-pack (chunked)

send-pack: unexpected disconnect while reading sideband packet

fatal: the remote end hung up unexpectedly

Everything up-to-date

 

원인

Git은 기본적으로 전송 가능한 파일 크기 제한(기본 약 1MB)이 설정되어 있습니다.

큰 이미지나 리소스 파일을 푸시할 경우, 이 제한을 초과하면서 전송이 중단됩니다.

 

해결 방법

아래 명령어를 통해 전송 버퍼 크기(postBuffer)를 늘려주면 해결됩니다.

 

✅ 로컬 저장소에만 적용

git config --local http.postBuffer 2048M
git config --local ssh.postBuffer 2048M

 

🌍 전역 설정으로 적용

git config --global http.postBuffer 2048M
git config --global ssh.postBuffer 2048M

 

local -> 현재 저장소에만 적용
global -> 내 모든 저장소에 공통 적용

 

 

추가 확인 사항

너무 큰 파일(수십 MB 이상)은 Git LFS(Git Large File Storage) 사용을 고려해야 합니다.
git push시 동일한 에러가 반복되면, 네트워크 연결 상태나 리모트 서버의 용량 제한도 확인해야 합니다.