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) |
| 🕶 visibilitychange | resetQuiz(false) or 무시 |
예시
1
2
3
4
5
6
7
8
9
// 뒤로가기 또는 이탈 시
useBeforeRouteLeave(true, () => {
resetQuiz(true); // 세션까지 삭제
});
// 새로고침 대비
window.addEventListener("beforeunload", () => {
resetQuiz(false); // 상태만 초기화
});
🧠 교훈
- 상태 초기화는 상황별로 구분하는 게 중요하다
- 특히 세션을 삭제하는 타이밍은 명확히 해야 함
resetQuiz(true)vsresetQuiz(false)구분만 잘 해도 UX가 깔끔해짐
📌 마무리
이번 트러블슈팅을 통해,
- Zustand 상태 관리의 세밀한 조정
- 세션 기반 캐싱/복원 구조
- 다양한 브라우저 이벤트 처리 (새로고침, 탭 이탈 등)
등을 한 번에 경험할 수 있었습니다. 앞으로도 퀴즈 상태 유지/복원 관련 고도화를 이어갈 예정입니다. 🔄
이 글은 Velog 에 처음 올렸습니다.
This post is licensed under CC BY 4.0 by the author.