Git에서 'Permission denied' 오류 해결 방법

Git을 사용하다 보면 cannot update the ref 'refs/remotes/origin/dev': unable to append to '.git/logs/refs/remotes/origin/dev': Permission denied 오류를 만날 수 있습니다. 이는 파일 접근 권한 문제로 인해 발생하는데, 이를 해결하는 방법을 단계별로 정리해 보았습니다.

1. 파일 권한 확인 및 수정

우선, 문제가 발생한 파일의 소유권과 권한을 확인해야 합니다.

ls -l .git/logs/refs/remotes/origin/dev

결과를 확인했을 때, 파일 소유자가 현재 로그인한 사용자와 다르다면 소유권을 변경해야 합니다.

sudo chown -R $(whoami) .git/

또는 Git 폴더 전체에 쓰기 권한을 부여하는 방법도 있습니다.

chmod -R u+w .git/

2. Git 명령어를 관리자 권한으로 실행

Linux 또는 macOS의 경우, sudo를 사용하여 명령어를 실행하면 권한 문제를 해결할 수 있습니다.

sudo git fetch

그러나 이 방법은 임시적인 해결책이므로, sudo 없이도 정상 작동하도록 파일 소유권을 수정하는 것이 좋습니다.

3. 파일 시스템이 읽기 전용인지 확인

현재 작업 중인 디렉터리가 읽기 전용 모드인지 확인해야 합니다.

mount | grep $(pwd)

출력 결과에서 ro(read-only)로 설정되어 있다면, 파일 시스템을 읽기-쓰기(rw) 모드로 변경해야 합니다.

sudo mount -o remount,rw /

4. 원격 브랜치 로그 파일 삭제 후 다시 가져오기

파일이 손상되었거나 권한 문제가 계속될 경우, 해당 파일을 삭제하고 다시 fetch를 시도해 볼 수 있습니다.

rm -f .git/logs/refs/remotes/origin/dev
git fetch --all

5. Git 저장소 무결성 검사

Git 저장소가 손상되었을 가능성이 있으므로 무결성 검사를 실행합니다.

git fsck

만약 저장소에 문제가 발견되면 새로운 저장소를 복제하는 것이 필요할 수도 있습니다.

6. 저장소를 새로 복제

위의 방법으로도 해결되지 않는다면, 저장소를 새로 복제하는 것이 가장 확실한 해결책입니다.

mv myrepo myrepo_backup  # 기존 폴더 백업
git clone <repository_url> myrepo  # 새로운 저장소 복제

이제 새로 복제된 저장소에서 다시 작업하면 정상적으로 동작할 가능성이 큽니다.

마무리

Git의 'Permission denied' 오류는 주로 파일 권한 문제로 인해 발생하며, 위의 14번 단계를 차례로 시도하면 대부분 해결할 수 있습니다. 만약 문제가 지속된다면, 56번 방법을 고려해 보세요.