fix: Refresh Token 재발급 추가 #77

[chwwwon]

🔗 Related Issue

• [REFACTOR] JWT 토큰 Refresh Token 수정 #77

📝 Description

무엇을(What)

• 기존 AccessToken 단일 사용 방식에서 RefreshToken을 이용해 AccessToken을 재발급할 수 있도록 인증 로직을 개선했습니다.
• 토큰 만료 시 재로그인 없이 인증을 유지할 수 있도록 토큰 갱신 API(/api/auth/refresh)를 추가 및 보완했습니다.
  왜(Why)
• AccessToken 만료 시마다 재로그인이 필요해 사용자 경험(UX)이 저하되는 문제가 있었습니다.
• 모바일/웹 환경에서 장시간 사용 시 인증 만료로 인한 이탈 가능성을 줄이기 위해 표준적인 AccessToken + RefreshToken 구조로 인증 체계를 개선했습니다.

기획 배경 및 비즈니스 문제

• 사용자가 앱을 장시간 사용하거나 백그라운드 전환 후 복귀할 경우 AccessToken 만료로 인해 갑작스럽게 로그아웃되는 문제가 발생했습니다.
• RefreshToken 기반 재발급 구조를 도입함으로써 서비스 이용 흐름을 끊지 않고 안정적인 인증 상태를 유지할 수 있도록 개선했습니다.

🛠 Changes

API 추가/수정

• POST /api/auth/refresh
  → RefreshToken을 이용해 새로운 AccessToken 발급

인증 로직 개선

• AccessToken 만료 시 RefreshToken 검증 후 토큰 재발급
• RefreshToken 유효성 검증 실패 시 재로그인 유도

응답 구조 통일

• 토큰 재발급 성공 시 기존 로그인 응답과 동일한 토큰 포맷 유지

✅ Test Checklist

변경 사항이 정상적으로 동작하는지 확인하기 위해 수행한 테스트 목록입니다.

• RefreshToken을 이용한 AccessToken 재발급 단위 테스트 작성 및 통과
• RefreshToken 만료/유효하지 않은 경우 에러 응답 정상 반환 확인
• 기존 로그인 API 동작에 영향 없는지 회귀 테스트 수행
• API 응답 포맷이 기획서 및 공통 응답 규격과 일치하는지 확인

[sonarqubecloud]

Quality Gate failed

Failed conditions
0.0% Coverage on New Code (required ≥ 80%)
B Reliability Rating on New Code (required ≥ A)

See analysis details on SonarQube Cloud

Catch issues before they fail your Quality Gate with our IDE extension SonarQube for IDE

[zzmnxn]

확인하고 머지해주세요!