[백엔드 변경사항 공유] 리프레시 토큰 만료 에러 코드 분리 ※프론트 대응 요청

[Be-HinD]

[백엔드 변경사항 공유] 리프레시 토큰 만료 에러 코드 분리

안녕하세요, 토큰 만료 관련 무한 재요청 이슈 대응으로 백엔드 변경사항이 생겨 공유드립니다.

---

변경 배경

기존에는 액세스 토큰 만료 / 리프레시 토큰 만료 모두 동일하게 EXPIRED_TOKEN (401) 을 반환하고 있었습니다.

이로 인해 프론트엔드에서 리프레시 토큰도 만료된 상황에서 에러 코드를 구별할 수 없어 무한 재요청이 발생하는 문제가 있었습니다.

---

변경 내용

POST /api/auth/refresh 호출 시 리프레시 토큰이 만료된 경우, 기존 EXPIRED_TOKEN 대신 EXPIRED_REFRESH_TOKEN 을 반환합니다.

응답 예시

HTTP 401 Unauthorized

{
  "type": "about:blank",
  "title": "EXPIRED_REFRESH_TOKEN",
  "status": 401,
  "detail": "인증 : 만료된 리프레시 토큰입니다. 재로그인이 필요합니다.",
  "instance": "/api/auth/refresh",
  "errorCode": "EXPIRED_REFRESH_TOKEN"
}

---

프론트엔드 대응 요청

errorCode 필드를 기준으로 아래와 같이 분기 처리 부탁드립니다.

errorCode	상황	대응
EXPIRED_TOKEN	액세스 토큰 만료	리프레시 토큰으로 재발급 시도
EXPIRED_REFRESH_TOKEN	리프레시 토큰 만료	재로그인 화면으로 이동 (재요청 금지)
DUPLICATE_LOGIN	다른 기기에서 로그인됨	재로그인 화면으로 이동 (재요청 금지)
INVALID_TOKEN	토큰 자체가 유효하지 않음	재로그인 화면으로 이동 (재요청 금지)

---

문의사항 있으시면 말씀해주세요!