상태 관리
우선순위: P2 (중간)
구현 가이드라인
- URL 상태: 공유 가능하거나 영속적인 상태에는 URL을 단일 진실 공급원(Single Source of Truth)으로 사용하세요. URL 매개변수는 새로고침과 링크 간에 공유 가능합니다.
useSearchParams()로 접근하고useRouter()로 업데이트합니다. 패턴:const params = new URLSearchParams(searchParams); params.set('q', term); useRouter().replace(...). - 서버 상태: 서버 데이터 캐싱 및 페칭에는 SWR 또는 TanStack Query (React Query) 를 사용하세요. 서버 데이터를 수동으로
useState에 동기화하지 마세요. - 클라이언트 상태: Zustand (
create<CartState>()((set) => ({ ... }))) — 'use client' 컴포넌트에서만 사용 — 또는 복잡하고 빈도가 높은 UI 상태에는 Jotai를 사용하세요. 낮은 빈도의 데이터에만 Context API를 활용하여 Prop Drilling을 피하세요. - 상태 끌어올리기: 상태를 컴포넌트에 최대한 가깝게 배치하세요. 상태가 형제 간에 공유될 때만 부모로 끌어올리세요.
- Next.js 15+ 통합: 클라이언트 컴포넌트의 상태 업데이트가 서버 사이드 렌더링 로직과 충돌하지 않도록 하세요. 낙관적 업데이트(optimistic updates) 는
useOptimistic훅을 사용하여 관리하세요. - 상태 수화(Hydration): 클라이언트 컴포넌트에서
localStorage로 상태를 초기화할 때 Hydration 오류를 방지하기 위해 주의하세요.useEffect로 감싸거나mounted플래그를 사용하세요.
2. URL-주도 상태 (검색/필터)
useSearchParams + useRouter를 사용하여 URL 매개변수를 업데이트하세요. URL 상태 패턴을 참조하세요.
3. 서버 상태 (TanStack Query / SWR)
클라이언트에서 "실시간" 데이터가 필요한 경우(예: 주식 가격 폴링, 채팅), 수동으로 useEffect로 fetch를 구현하지 마세요. 라이브러리를 사용하세요.
// 자동 캐싱, 중복 제거, 재검증(refreshInterval 사용)
const { data, error } = useSWR('/api/user', fetcher, {
refreshInterval: 30000,
});
라이브러리 패턴
특정 상태 관리 패턴에 대해서는 다음을 참조하세요:
반패턴(Anti-Patterns)
- 단순한 상태에 전역 저장소 사용 금지:
useState나 URL 매개변수를 사용하세요. 기본 UI에 Zustand를 사용하지 마세요. - 상태에 큰 객체 사용 금지: 세분화된 기본 타입으로 분해하여 불필요한 리렌더링을 방지하세요.
- 데이터 페칭에
useEffect사용 금지: 서버 상태에는 SWR 또는 TanStack Query를 사용하세요. - 클라이언트 저장소에 서버 상태 저장 금지: RSC에서 데이터를 가져오고, 클라이언트 저장소는 UI 전용 상태를 위해 사용하세요.