n8n, Google Calendar OAuth2 인증 오류

n8n을 Docker에 설치해서 잘 사용하다가, 서버를 재시작하거나 Docker 컨테이너를 다시 실행했더니 Google Calendar 인증이 풀리는 경험, 해보셨나요?

문제 상황: 도커 재시작 후 인증 오류 발생

n8n에서 Google Calendar를 OAuth2로 연결했을 때, 아래와 같은 에러가 발생했습니다

The provided authorization grant (e.g., authorization code, resource owner credentials) or refresh token is invalid, expired, revoked, does not match the redirection URI used in the authorization request, or was issued to another client.

분명 처음에는 잘 연결되었는데, 컨테이너를 껐다가 다시 키고 나니 인증이 풀려버리는 현상입니다.

원인 진단

원인	설명
🔑 Refresh Token 만료 또는 철회됨	사용자가 Google 계정에서 앱 연결을 취소했거나 토큰이 오래되어 만료된 경우
🔁 Authorization Code 재사용	OAuth 코드가 일회성이며 이미 사용된 경우
🌐 Redirect URI 불일치	Google API Console에 등록된 redirect URI와 n8n 설정이 다를 때
👤 다른 클라이언트용 토큰 사용	다른 프로젝트/앱에서 발급된 토큰을 잘못 사용하는 경우
📆 OAuth 인증 유효 기간 경과	토큰 갱신이 안 되어 더 이상 유효하지 않은 경우

🔐 Google 인증 자체가 만료됐거나 취소된 경우

심지어 인증정보가 저장되더라도, 다음의 이유로 Google 쪽에서 토큰이 무효화될 수 있습니다

 

원인	설명
✅ 사용자가 Google 계정에서 앱 연결을 직접 해제	Google 보안 설정 > 연결된 앱
🔁 리프레시 토큰 자체가 만료	7일 이상 사용 안 하면 만료 가능
⛔ 리디렉션 URI 불일치	n8n에서 사용하는 도메인 변경, ngrok 주소 갱신 등
🆕 새 Google 프로젝트로 Credentials 바뀜	예전 토큰은 무효 처리됨

 

이 경우엔 자격 증명(Credentials)을 재인증(Reconnect) 해주셔야 합니다.

 

🛠 해결 방법

✅ 자격 증명(credential) 재연결

1. n8n 좌측 메뉴 > Credentials > Google Calendar OAuth2Api 선택
2. "Reconnect" 또는 새로 연결
3. 올바른 Google 계정으로 로그인
4. 인증 후 정상 동작 확인

 

✨ 정리: 인증이 계속 풀린다면 이렇게 점검하세요

1. 볼륨 마운트가 올바르게 되고 있는지 (~/.n8n)
2. 컨테이너가 유지되고 있는지 (docker-compose 추천)
3. Google 계정에서 앱 권한이 유지되고 있는지
4. Redirect URI가 Google Cloud와 일치하는지