[React] GitHub Pages 배포 중 gh-pages 에러 해결하기

gh-pages -d build 명령어를 통해 GitHub Pages로 프로젝트를 배포하던 중, 깃허브 계정의 비밀번호를 잘못 입력하여 작업이 중단되었다. 이후 다시 gh-pages -d build 명령어를 실행해보았지만 다음과 같은 에러가 발생했다.

fatal: a branch named 'gh-pages' already exists

 

시도한 방법

• gh-pages 브랜치 삭제
  로컬 및 원격 저장소에서 gh-pages 브랜치를 삭제했지만 오히려 삭제할 브랜치가 없다는 것만 확인하고 동일한 에러가 발생했다.
• Docker 컨테이너 삭제 및 재빌드
  프로젝트 환경을 초기화하기 위해 실행 중이던 Docker 컨테이너를 삭제하고 재빌드했지만 문제는 해결되지 않았다.

문제의 원인

에러 메시지와 실행 로그를 분석한 결과, node_modules/gh-pages의 내부적으로 사용하는 캐시 파일에 gh-pages 브랜치 관련 기록이 남아 있는 것으로 보였다. 

at ChildProcess.<anonymous> (/app/node_modules/gh-pages/lib/git.js:42:16)

 

이를 기반으로 node_modules/.cache/gh-pages 디렉터리에 기록이 남아 있어 문제가 발생한 것으로 판단했다.

 

해결 방법

node_modules/.cache/gh-pages 디렉터리를 삭제한 후, 다시 gh-pages -d build 명령어를 실행한 결과 문제가 해결되었다.

rm -rf node_modules/.cache/gh-pages
gh-pages -d build

 

 

배운 점

1. 비정상 종료가 발생하면 내부 캐시 파일이 원인이 될 수 있음으로 캐시 삭제를 시도해볼 수 있다.