Repository navigation
ELOG 021 auth refresh rotation race
wcorn edited this page Jul 23, 2026
·
1 revision
| 항목 | 내용 |
|---|---|
| 분류 | 🔧 트러블슈팅 |
| 날짜 | 2026-07-24 |
| 영역 | FE / BE |
| 관련 이슈/PR | #964, #965 |
| 상태 | 조치 완료(배포 대기) — 배포 후 재로그인 빈도 확인 예정 |
"로그인을 너무 자주 하게 된다"는 제보. 특정 조작이 아니라 앱을 쓰다 보면 간헐적으로 /login으로 튕겼다.
토큰 수명 자체는 짧지 않았다:
- 엑세스 토큰 30분(
iat/exp디코드로 확인), zustand 메모리 전용(localStorage 미사용) → 새로고침/새 탭마다 사라짐. - 리프레시 토큰 14일(JWT · Redis · httpOnly 쿠키 max-age 모두 일치).
즉 TTL이 짧아서가 아니었다.
Playwright로 운영 사이트에 로그인해 직접 재현·계측했다.
- 신선한 세션에서 새로고침 →
POST /api/auth/reissue200(정상 재발급, 노트 유지). → 단일 탭 흐름은 정상. - 시간이 지난(≈1시간) 세션에서 새로고침 →
reissue401AUTH-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.
즉 회전이 단일 사용인데 재발급 호출이 조율되지 않아 정상 세션이 스스로를 로그아웃시키고 있었다.
업계 표준(Auth0의 회전 유예, OAuth 2.0 Security BCP §4.14 재사용 감지)에 맞춰 서버 유예 창 + 클라 탭 간 단일 재발급을 함께 적용했다.
-
RefreshTokenRepository:auth:refresh:grace:<id>키(TTL 30초) 추가.deleteByMemberId는 현재·유예 둘 다 삭제. -
AuthService.reissue:- 요청 토큰 == 현재 토큰 → 정상 회전하되, 직전 토큰을 grace로 남긴다.
- 요청 토큰이 현재와 다르지만 유예 창의 직전 토큰이면 → 재회전하지 않고 현재 토큰으로 수렴시켜 반환(동시에 온 형제 요청이 같은 RT를 갖게).
- 둘 다 아니면 거부(유예 밖 재사용/폐기).
-
refreshCoordinator.refreshAccessToken(): 탭 내 단일 비행 + Web Locks(브라우저당 동시 재발급 1개) + BroadcastChannel(새 토큰을 다른 탭에 전파 → 그 탭들이 또 재발급/로그아웃당하지 않게). 둘 다 feature-detect(미지원 시 폴백). -
client인터셉터를 코디네이터로 통합하고, 토큰이 이미 바뀌었으면 재발급 없이 재시도(불필요한 회전 절약). 앱 시작 재발급도 같은 경로를 쓰게 위임.
- 단위/통합 테스트로 메커니즘 검증: BE 유예 수렴(재회전 안 함)·유예 밖 거부, FE 동시 호출 단일 비행(서버 1회)·토큰-변경 재시도. FE 492개·BE auth 테스트·체크스타일 통과.
- 배포 후 다중 탭 사용 시 재로그인 빈도 감소를 확인할 예정(운영 수치는 배포 후 갱신).
-
"자주 로그아웃된다"는 토큰 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