Post

Zustand 상태 초기화 & 세션 유지 트러블슈팅

Zustand 상태 초기화 & 세션 유지 트러블슈팅

resetQuiz()가 너무 잘 작동(?)해서 생긴 이슈를 해결한 기록입니다.


💥 문제 요약

퀴즈를 풀다가 아래와 같은 상황이 발생했습니다:

  • 새로고침하면 퀴즈가 초기화됨
  • 퀴즈를 다 풀지 않았는데 뒤로가기를 누르면 상태가 유지되거나 깨짐
  • 퀴즈 제출 후 상태가 리셋되지 않아 결과 페이지에서 문제 발생

의도와 다르게 resetQuiz()가 모든 상황에서 세션까지 삭제하고 있었음 😨


🔍 원인 분석

1. Zustand 상태 + 세션 스토리지의 구조

1
2
3
4
5
6
7
8
resetQuiz: () => {
  const { quizId, attemptId } = get();
  if (quizId && attemptId) {
    sessionStorage.removeItem(`quiz-${quizId}-${attemptId}`);
    sessionStorage.removeItem("lastAttempt");
  }
  set({ ...모든 상태 초기화 });
}

→ 즉, resetQuiz()는 언제 호출되든 무조건 세션까지 삭제함.

2. 새로고침, 페이지 이탈, 뒤로가기 전부 동일한 cleanup 처리

1
2
3
4
5
6
7
useEffect(() => {
  const cleanup = () => resetQuiz(); // 항상 세션 제거

  window.addEventListener("beforeunload", cleanup);
  document.addEventListener("visibilitychange", ...);
  ...
}, []);

✅ 해결 전략

🔧 1. resetQuiz(forceDelete: boolean = false) 로직 개선

1
2
3
4
5
6
7
8
9
10
11
12
13
14
resetQuiz: (forceDelete = false) => {
  const { quizId, attemptId } = get();

  if (forceDelete && quizId && attemptId) {
    sessionStorage.removeItem(`quiz-${quizId}-${attemptId}`);
    sessionStorage.removeItem("lastAttempt");
  }

  set({
    quizId: null,
    attemptId: null,
    ...초기 상태들
  });
}

🔧 2. 상황에 따라 분기 처리

상황처리 방식
🔄 새로고침resetQuiz(false) or 무시
🚪 페이지 이탈 / 뒤로가기resetQuiz(true)
✅ 퀴즈 제출resetQuiz(true)
🕶 visibilitychangeresetQuiz(false) or 무시

예시

1
2
3
4
5
6
7
8
9
// 뒤로가기 또는 이탈 시
useBeforeRouteLeave(true, () => {
  resetQuiz(true); // 세션까지 삭제
});

// 새로고침 대비
window.addEventListener("beforeunload", () => {
  resetQuiz(false); // 상태만 초기화
});

🧠 교훈

  • 상태 초기화는 상황별로 구분하는 게 중요하다
  • 특히 세션을 삭제하는 타이밍은 명확히 해야 함
  • resetQuiz(true) vs resetQuiz(false) 구분만 잘 해도 UX가 깔끔해짐

📌 마무리

이번 트러블슈팅을 통해,

  • Zustand 상태 관리의 세밀한 조정
  • 세션 기반 캐싱/복원 구조
  • 다양한 브라우저 이벤트 처리 (새로고침, 탭 이탈 등)

등을 한 번에 경험할 수 있었습니다. 앞으로도 퀴즈 상태 유지/복원 관련 고도화를 이어갈 예정입니다. 🔄


이 글은 Velog 에 처음 올렸습니다.

This post is licensed under CC BY 4.0 by the author.