git push가 갑자기 안 될 때 — GitHub Personal Access Token 만료 해결법

분명히 저번 주까지 잘 됐던 git push가 갑자기 안 됐다.

코드를 바꾼 것도 없고, 설정을 건드린 것도 없는데 터미널에 이런 메시지가 떴다.

remote: Invalid username or token. Password authentication is not supported for Git operations.
fatal: Authentication failed for 'https://github.com/...'

처음엔 내가 뭔가 잘못한 줄 알았는데, 원인은 단순했다. GitHub Personal Access Token의 유효기간이 만료된 것이었다.

왜 갑자기 push가 안 되는 걸까

GitHub는 2021년부터 비밀번호로 push하는 방식을 차단했다. 대신 Personal Access Token(PAT)이라는 인증 수단을 사용한다. 처음 GitHub 연동할 때 발급받아서 등록해두는 그 토큰인데, 발급 시 설정한 유효기간이 지나면 자동으로 만료된다.

만료된 토큰으로는 push가 불가능하다. 저번 주까지 됐다가 갑자기 안 되는 이유가 바로 이것이다.

토큰 만료 여부 확인하는 법

GitHub 사이트에서 직접 확인할 수 있다. 아래 경로로 들어가면 된다.

• 1 GitHub.com 로그인
• 2 오른쪽 상단 프로필 사진 클릭 → Settings
• 3 왼쪽 사이드바 맨 아래 Developer settings
• 4 Personal access tokens → Tokens (classic)

토큰 목록에서 Expired 표시가 있으면 만료된 것이다.

Tokens (classic) 목록에서 Expired 표시로 만료 여부를 확인할 수 있다

해결 방법 — 토큰 재발급 후 재등록

만료된 토큰을 재발급하고, VS Code 터미널에서 새 토큰을 등록해주면 된다.

• 1 만료된 토큰 클릭 → Regenerate token 버튼 클릭
• 2 만료일을 No expiration으로 변경 후 재발급
• 3 생성된 토큰 문자열 복사 — 이 화면 벗어나면 다시 못 봄
• 4 VS Code 터미널에서 아래 명령어 입력

# 토큰 자리에 복사한 토큰 붙여넣기
git remote set-url origin https://토큰@github.com/계정명/저장소명.git

이후 git push를 다시 실행하면 정상적으로 동작한다.

 

💡 No expiration으로 설정하면 다음엔 이 문제 안 생긴다 토큰 재발급 시 만료일을 No expiration으로 설정해두면 유효기간 없이 계속 사용할 수 있다. 개인 프로젝트 용도라면 이 설정이 편하다. 보안이 중요한 환경이라면 주기적으로 재발급하는 게 맞지만, 혼자 쓰는 포트폴리오 저장소라면 No expiration이 현실적이다.

멀쩡하던 git push가 갑자기 안 된다면 GitHub Personal Access Token 만료를 먼저 의심해보자.
GitHub Settings → Developer settings → Tokens (classic)에서 Expired 여부를 확인하고, Regenerate로 재발급 후 remote URL에 새 토큰을 등록하면 해결된다.
재발급 시 만료일을 No expiration으로 설정해두면 같은 문제가 반복되지 않는다.