🛠️ Git 관련 오류 해결

Git 오류 메시지
fatal: unable to read tree

fatal: unable to read tree 오류 메시지는 Git이 해당 커밋 또는 트리 객체를 읽을 수 없어서 저장소에 문제가 생겼다는 메시지이다.
OneDrive 동기화 폴더에 저장소가 있었는데 OneDrive 연결을 해제하고 Document 하위로 Vault를 이동하던 중에 문제가 생긴 것 같다.

🛠️ 원인

1. 파일 시스템 문제 또는 Git 내부 오류

• NFS, Dropbox, Google Drive, OneDrive 같은 동기화 폴더에 저장소가 있을 경우 문제 발생 가능

2. 디스크 오류 / 네트워크 오류 (원격 저장소에서 clone한 경우)

• git clone 도중 강제 종료되었거나 네트워크 연결이 끊겨 저장소 일부만 복사된 경우에도 발생 가능

3. Git 저장소가 손상됨 (repository corruption)

• .git/object/폴더 내의 데이터가 손상되었거나 일부가 삭제된 경우
• 특히 Git이 특정 트리 객체를 찾을 수 없을 때 fatal: unable to read tree 오류 출력

🧪 해결 방법

Step 1. 기존 폴더 삭제하기

Windows CMD 기준

rmdir /s /q "C:\Users\USER\Documents\Obsidian\wononul"

Windows PowerShell 기준

Remove-Item -Recurse -Force "C:\Users\USER\Documents\Obsidian\wononul"

Caution 위 명령어는 폴더를 강제로 삭제하므로, 중요한 파일이 있는 경우 반드시 백업 후 진행

Step 2. 원격 저장소에서 다시 clone

git clone (원격저장소 주소)

Step 3. 정상 여부 확인

cd (vault가 존재하는 디렉토리)  
git status  

정상적으로 clone이 완료되었다면 git status 명령어에서 오류 없이 현재 브랜치 상태를 출력한다.