Skip to content

ELOG 021 auth refresh rotation race

wcorn edited this page Jul 23, 2026 · 1 revision

ELOG-021: 리프레시 토큰 회전 레이스로 재로그인이 잦음

항목 내용
분류 🔧 트러블슈팅
날짜 2026-07-24
영역 FE / BE
관련 이슈/PR #964, #965
상태 조치 완료(배포 대기) — 배포 후 재로그인 빈도 확인 예정

1. 상황 (Before)

"로그인을 너무 자주 하게 된다"는 제보. 특정 조작이 아니라 앱을 쓰다 보면 간헐적으로 /login으로 튕겼다.

토큰 수명 자체는 짧지 않았다:

  • 엑세스 토큰 30분(iat/exp 디코드로 확인), zustand 메모리 전용(localStorage 미사용) → 새로고침/새 탭마다 사라짐.
  • 리프레시 토큰 14일(JWT · Redis · httpOnly 쿠키 max-age 모두 일치).

즉 TTL이 짧아서가 아니었다.

2. 원인 분석

Playwright로 운영 사이트에 로그인해 직접 재현·계측했다.

  • 신선한 세션에서 새로고침 → POST /api/auth/reissue 200(정상 재발급, 노트 유지). → 단일 탭 흐름은 정상.
  • 시간이 지난(≈1시간) 세션에서 새로고침 → reissue 401 AUTH-ERR-002("유효하지 않은 토큰") → /login으로 튕김.

코드를 보니 reissue가 단일 사용(single-use) 회전이었다:

  • RefreshTokenRepository는 회원당 최신 토큰 1개만 Redis에 저장.
  • AuthService.reissue가 요청 토큰과 저장 토큰의 정확 일치를 요구하고, 통과하면 새 토큰으로 회전(덮어쓰기).

여기에 동시성이 겹치면 서로를 무효화한다:

  • FE의 재발급 single-flight 가드(isRefreshing/pendingRequests)는 탭(모듈) 단위라 탭 간 공유가 안 됨. 쿠키는 모든 탭이 공유.
  • 다중 탭(노트/플래너는 흔함)에서 각 탭이 자기 30분 주기로 재발급하거나, 앱 시작 재발급(providers)이 인터셉터 재발급과 겹치면: 한쪽이 R1→R2로 회전 → 다른 쪽은 아직 R1로 reissue → 서버엔 R2뿐 → 불일치 → INVALID_TOKEN → 그 탭은 /login.

즉 회전이 단일 사용인데 재발급 호출이 조율되지 않아 정상 세션이 스스로를 로그아웃시키고 있었다.

3. 조치

업계 표준(Auth0의 회전 유예, OAuth 2.0 Security BCP §4.14 재사용 감지)에 맞춰 서버 유예 창 + 클라 탭 간 단일 재발급을 함께 적용했다.

BE — 회전 유예 창 (30초)

  • RefreshTokenRepository: auth:refresh:grace:<id> 키(TTL 30초) 추가. deleteByMemberId는 현재·유예 둘 다 삭제.
  • AuthService.reissue:
    • 요청 토큰 == 현재 토큰 → 정상 회전하되, 직전 토큰을 grace로 남긴다.
    • 요청 토큰이 현재와 다르지만 유예 창의 직전 토큰이면 → 재회전하지 않고 현재 토큰으로 수렴시켜 반환(동시에 온 형제 요청이 같은 RT를 갖게).
    • 둘 다 아니면 거부(유예 밖 재사용/폐기).

FE — 탭 간 재발급 단일화

  • refreshCoordinator.refreshAccessToken(): 탭 내 단일 비행 + Web Locks(브라우저당 동시 재발급 1개) + BroadcastChannel(새 토큰을 다른 탭에 전파 → 그 탭들이 또 재발급/로그아웃당하지 않게). 둘 다 feature-detect(미지원 시 폴백).
  • client 인터셉터를 코디네이터로 통합하고, 토큰이 이미 바뀌었으면 재발급 없이 재시도(불필요한 회전 절약). 앱 시작 재발급도 같은 경로를 쓰게 위임.

4. 결과 (After)

  • 단위/통합 테스트로 메커니즘 검증: BE 유예 수렴(재회전 안 함)·유예 밖 거부, FE 동시 호출 단일 비행(서버 1회)·토큰-변경 재시도. FE 492개·BE auth 테스트·체크스타일 통과.
  • 배포 후 다중 탭 사용 시 재로그인 빈도 감소를 확인할 예정(운영 수치는 배포 후 갱신).

5. 교훈 / 후속

  • "자주 로그아웃된다"는 토큰 TTL부터 의심하기 쉽지만, 회전(single-use)+동시성이 더 흔한 범인. TTL이 정상이면 재발급 응답 코드(AUTH-ERR-002 등)와 동시 호출 경로부터 본다.
  • Playwright로 운영에서 직접 재현(신선 세션 200 vs stale 세션 401)한 게 원인 확정의 결정타였다.
  • SPA 토큰 재발급은 서버 유예 창 + 클라 탭 간 단일화를 한 세트로 본다(둘 중 하나만으론 레이스가 남는다).
  • 후속: 쿠키 SameSite=Strict/secure는 운영 origin(orino.dev↔api.orino.dev, HTTPS)에선 정상. 다른 site/http 환경 지원이 필요하면 별도 검토. 엑세스 토큰 메모리 전용 정책은 유지(재발급 경로가 이를 보완).

참고

  • 관련: ELOG-004 (만료 시 401 통일 — FE 자동 재발급 트리거의 전제)
  • 설계: Auth Architecture
  • 이슈/PR: #964, #965

Clone this wiki locally