원인 및 조치 (앱 MR 리뷰 대기)¶
검증된 원인
세션 토큰 갱신(refreshSession)이 앱 콜드스타트 1회 App effect에만 연결되어 있었습니다. bearer RPC 호출 경로와 AppState 포그라운드 복귀 시점에는 액세스 토큰 만료 검사·갱신이 없어서, 1시간짜리 Connect 액세스 토큰이 만료되면(예: 앱을 잠시 백그라운드에 두었다 복귀) 앱을 재시작하기 전까지 보호된 모든 화면(퀘스트/포인트 내역/추천/리워드)이 인증 실패 상태로 남았습니다. 재시작 시 콜드스타트 effect가 다시 실행되어 일시적으로 복구되던 것도 같은 이유입니다.
조치 (앱 MR)
- 요청 전 preflight 및 포그라운드 복귀 시 토큰 갱신 추가
- 회전 토큰 single-flight 처리(동시 갱신 중복 제거)
- 오래된 refresh와 신규 로그인을 구분하는 세대(generation) 가드
- 종료성/일시적 오류 라우팅 분리
- 재전송 없는 mutation 복구
- 안전한 읽기 1회 재시도
- 레거시 GoTrue 토큰 저장소 폴백 제거
MR: https://git.alphea.io/Alphea-Dev/alphea-connect-app/-/merge_requests/1 (commit 7f7ba1c2ae15f75b9dca0b1efa9b500da29e30a3, target dev, open/mergeable)
검증: 이 저장소 GitLab 워크플로는 staging에서만 실행되어 브랜치/MR 파이프라인이 생성되지 않습니다. 로컬 독립 검증 모두 통과 — git diff --check, npm run typecheck, npm test -- --runInBand (65 suites / 514 tests), npm run lint (0 errors, 92 baseline warnings), npx madge --extensions ts,tsx --circular src (171 files, no cycles).
상태: MR 리뷰/머지 대기 중입니다. 아직 배포·해결 완료가 아닙니다.
