캐싱 아키텍처
우선순위: P1 (높음)
Next.js에는 4가지 고유한 캐싱 레이어가 있습니다. 이들을 이해하면 오래된 데이터 버그를 방지할 수 있습니다.
구현 지침
- Next.js 15+ 표준: API 호출에는
fetch와 함께revalidate: number또는cache: 'force-cache'** 를 사용하세요. 사용자 정의 데이터 저장소에는 **unstable_cache** 또는 새로운 **'use cache'` (실험적)를 사용하세요. - 레이어: 데이터 캐시 (요청 간 지속)와 요청 메모이제이션 (React 생명 주기와 관련)을 구분하세요. 단일 렌더링 내에서 fetch를 중복 제거하려면 React의
cache()를 사용하세요. - 무효화: 변이 후
revalidatePath('/')를 사용하거나 세분화된 캐시 제거를 위해revalidateTag('tag-name')를 사용하세요. - 클라이언트 캐시: 라우터 캐시 (클라이언트의 메모리 내)와 30초에서 1분 수명을 이해하세요.
router.refresh()를 사용하여 지우세요. - 정적 자산: 빌드 시 정적 경로를 사전 렌더링하기 위해
generateStaticParams를 활용하세요. 주기적으로 업데이트되는 콘텐츠에는 ISR (증분 정적 재생성) 을 사용하세요. - 스트리밍: 느린 데이터가 전체 페이지 렌더링을 차단하지 않도록
Suspense와fetch트리거를 결합하세요. - Next.js 16+: 가능한 경우
revalidate: number대신'use cache'와cacheLife()를 선호하여 결정론적 캐싱을 구현하세요.
| 레이어 | 위치 | 제어 방식 |
|---|---|---|
| 요청 메모이제이션 | 서버 | React cache() |
| 데이터 캐시 | 서버 | 'use cache', revalidateTag |
| 전체 라우트 캐시 | 서버 | 정적 사전 렌더링 |
| 라우터 캐시 | 클라이언트 | router.refresh() |
구현 세부사항
자세한 키 생성, 클로저 제약 조건, 무효화 전략은 캐시 컴포넌트 및 PPR을 참조하세요.
안티 패턴
- Next.js 16+에서
unstable_cache사용 금지: 대신'use cache'디렉티브와cacheLife()를 사용하세요. - 서버 데이터에
router.refresh()사용 금지: 대상 캐시 제거에는revalidateTag()를 선호하세요. - 라우트 수준에서 사용자별 데이터 캐싱 금지: 개인 데이터는
'use cache'와 함께<Suspense>로 감싸세요. - 태그 없이 장기 캐시 사용 금지: 세분화된 무효화 제어를 위해
cacheTag()를 할당하세요.