AI Agent Developer 황화인 blog

로컬 git 레포지토리가 손상되어서 push 해도 반영이 안되는 경우

11 min read

안녕하세요. GitHub 리포지토리 push 문제로 어려움을 겪고 계시는군요. 터미널 로그와 GitHub 스크린샷을 통해 현재 상황을 파악해 보니, 몇 가지 복합적인 문제가 얽혀있는 것으로 보입니다. 주된 원인은 로컬 Git 리포지토리가 손상되었을 가능성이 높습니다.

현재 상황 분석

  1. 리포지토리 손상 징후:

    • git checkout hwain2 또는 hwain 실행 시 fatal: unable to read tree 메시지가 나타납니다. 이는 Git이 특정 브랜치의 파일 상태(tree)를 읽을 수 없을 때 발생하는 것으로, 로컬 리포지토리에 손상이 있음을 시사합니다.
    • git pull origin main을 실행했을 때 fatal: unresolved deltas left after unpacking 및 fatal: unpack-objects failed 오류가 발생했습니다. 이는 원격 리포지토리의 변경 사항을 가져와 로컬에 적용하는 과정에서 객체 압축 해제에 실패했다는 의미로, 이 또한 로컬 리포지토리의 손상이나 네트워크 문제로 인해 발생할 수 있습니다.
    • git push origin hwain3 시도 시 fatal: bad tree object 오류가 발생했습니다. 이는 로컬 커밋에 포함된 파일 중 일부가 손상되었거나 Git 데이터베이스에 문제가 생겼을 때 나타나는 대표적인 증상입니다.

  2. 브랜치 상태 불일치:

    • GitHub 원격 리포지토리에는 main, hwain, jin_sup 3개의 브랜치가 존재합니다.
    • 하지만 사용자님의 로컬 터미널에서 git remote show origin 명령어를 실행했을 때, jin_sup 브랜치는 new (next fetch will store in remotes/origin) 상태로 표시됩니다. 이는 아직 로컬에 origin/jin_sup 이라는 원격 추적 브랜치가 생성되지 않았음을 의미합니다. git fetch 명령을 실행하면 해당 브랜치 정보를 가져올 수 있습니다.
    • 현재 git branch 실행 결과 * (no branch, rebasing main)로 표시된 부분이 있었습니다. 이는 이전에 git rebase 작업을 시도하다가 완료되지 않고 중단된 상태임을 나타냅니다. 이 상태에서 다른 작업을 시도하면서 문제가 더 복잡해졌을 수 있습니다.

해결 방안

리포지토리가 이미 손상되었을 가능성이 높기 때문에, 가장 안전하고 확실한 방법은 현재까지의 변경 사항을 백업하고 리포지토리를 새로 복제(clone)하여 작업을 이어가는 것입니다.

1. 현재 작업 내용 백업

가장 먼저, 새로 커밋한 hwain3 브랜치의 작업 내용을 안전한 곳에 복사하여 백업해두세요. 특히 git add . 와 git commit -m 'hwain3' 를 통해 추가하거나 변경했던 23개의 파일들을 별도의 폴더에 복사해 두는 것이 중요합니다.

2. 새로운 로컬 리포지토리 준비

  • 기존의 aug-08month_project5 폴더의 이름을 변경하거나 삭제합니다.

  • 커맨드 라인에서 다음 명령어를 실행하여 원격 리포지토리를 새로 복제합니다.

    git clone https://github.com/LonerStayle/aug-08month_project5.git

  • 새로 생성된 aug-08month_project5 폴더로 이동합니다.

    cd aug-08month_project5

3. 백업한 작업 내용 복원 및 Push

  • 새로 복제한 리포지토리에서 새로운 브랜치(hwain3 또는 다른 이름)를 생성하고 그 브랜치로 이동(checkout)합니다.

    git checkout -b hwain3

  • 백업해두었던 파일들을 hwain3 브랜치의 작업 디렉토리에 붙여넣기 합니다.

  • 파일들이 정상적으로 복원되었으면, 다시 커밋하고 원격 리포지토리로 push 합니다.

    git add .
git commit -m "hwain3 작업 내용 복구"
git push origin hwain3

이 과정을 통해 손상된 로컬 리포지토리를 버리고 깨끗한 상태의 리포지토리에서 작업을 다시 시작함으로써 문제를 해결할 수 있습니다.

용량이 큰 파일로 인해 push가 안된 경우

아니요, 정상적으로 완료되지 않았습니다. 오류 메시지를 자세히 살펴보면 실패한 것을 명확히 알 수 있습니다.

성공적으로 보일 수 있는 부분(Writing objects: 100%)과 실패를 알리는 부분이 섞여 있어 혼란스러우실 수 있습니다. 하나씩 설명해 드리겠습니다.

로그 분석

  1. Writing objects: 100% (234/234), 1.36 GiB | 21.70 MiB/s, done.

    • 의미: 이것은 Push 과정의 첫 단계입니다. 사용자님의 컴퓨터(로컬)에서 변경된 파일들을 압축하고 원격 서버(GitHub)로 전송하는 과정입니다.
    • 분석: 여기서 중요한 것은 전송된 데이터의 크기가 1.36 GiB라는 점입니다. 이것은 매우 큰 용량입니다. 이 단계 자체는 100% 완료되어 파일 데이터 전송을 시도했다는 의미입니다.

  2. error: RPC failed; HTTP 408 curl 22 The requested URL returned error: 408

    • 의미: 이것이 결정적인 오류 메시지입니다. HTTP 408은 “Request Timeout” 오류로, 데이터를 보내는 데 너무 오랜 시간이 걸려서 서버(GitHub)가 연결을 끊어버렸다는 뜻입니다.
    • 분석: 1.36 GiB나 되는 대용량 파일을 전송하다 보니 GitHub가 허용하는 시간 제한을 초과해 버린 것입니다.

  3. fatal: the remote end hung up unexpectedly

    • 의미: “원격 서버가 예기치 않게 연결을 끊었습니다.” 라는 뜻으로, 위 408 타임아웃 오류의 결과입니다.

  4. Everything up-to-date

    • 의미: 이 메시지는 보통 Push할 내용이 없을 때 나타납니다. 하지만 이 경우, Push가 실패한 직후에 나타났기 때문에 “Push가 실패했으니, 결과적으로 원격 저장소와 비교했을 때 새로운 변경 사항은 반영되지 않은 상태다”라는 의미로 해석할 수 있습니다. 성공했다는 뜻이 절대 아닙니다.

결론 및 원인

결론: Push는 실패했습니다. GitHub 페이지에 가서 hwain3 브랜치를 확인해 보시면 새로운 커밋이 반영되지 않은 것을 보실 수 있습니다.

주요 원인: 커밋에 **매우 큰 파일(1.36 GiB)**이 포함되어 있기 때문입니다. 이전 로그를 보면 hwa_in/model_save/best_model_epoch15_f1_0.7535.pth 와 같은 머신러닝 모델 파일이 포함된 것으로 보입니다. 이런 .pth 파일들은 용량이 매우 큰 경우가 많으며, 보통 Git으로 관리하지 않고 .gitignore에 추가하여 추적을 피합니다.

해결 방법

가장 최근의 커밋을 취소하고, 대용량 파일을 제외한 뒤 다시 커밋하여 Push해야 합니다.

1. 가장 최근 커밋 취소하기

아래 명령어를 실행하여 가장 최근에 했던 git commit -m "hwain3 작업 내용 복구" 커밋을 취소하세요. 파일 변경 내용은 그대로 남아있습니다.

git reset HEAD~1

2. 대용량 파일(.pth)을 .gitignore에 추가하기

프로젝트의 최상위 폴더 (C:\aug-08month_project5)에 .gitignore 파일이 있는지 확인하고, 없다면 새로 만드세요. 그리고 그 파일 안에 아래 내용을 추가하거나 기존 내용 밑에 덧붙입니다.

# .gitignore

# Model files
*.pth

메모장으로 직접 수정하거나, 아래 명령어를 터미널에 입력해도 됩니다.

echo "*.pth" >> .gitignore

3. .gitignore 파일과 대용량 파일을 Git 추적에서 제외하기

이제 .gitignore 파일을 Git에 추가하고, 캐시에 남아있을 수 있는 .pth 파일을 제거합니다.

# .gitignore 파일을 커밋에 포함시키기 위해 add
git add .gitignore
 
# 캐시에서 .pth 파일을 제거 (실제 파일은 삭제되지 않음)
git rm --cached hwa_in/model_save/best_model_epoch15_f1_0.7535.pth

4. 다시 커밋하고 Push하기

이제 대용량 파일이 제외되었으니, 다시 커밋하고 Push를 시도합니다.

git commit -m "hwain3 작업 내용 (대용량 파일 제외)"
git push origin hwain3

이제는 Push 용량이 훨씬 작아져서 시간 초과 없이 성공적으로 완료될 것입니다.

Graph View