렌더링 전략 (App Router)
우선순위: P0 (중요)
데이터 신선도와 확장 요구 사항에 따라 렌더링 전략을 선택합니다. 전략 매트릭스를 참조하세요.
구현 지침
- SSG (정적 사이트 생성): App Router의 기본값입니다. **
generateStaticParams**를 사용하여 빌드 시점에 라우트를 사전 렌더링합니다.cache: 'force-cache'옵션과 함께 **fetch**를 사용하여 트리거됩니다. - SSR (서버 사이드 렌더링):
cookies(),headers()또는cache: 'no-store'옵션과 함께 **fetch**를 사용하여 트리거됩니다. 개인화되거나 신선도가 높은 데이터에 사용합니다. - ISR (증분 정적 재생성): 빌드 후 정적 콘텐츠를 업데이트합니다.
revalidate(시간 기반) 또는revalidatePath/revalidateTag(온디맨드)를 사용합니다. - 스트리밍: **
Suspense**를 사용하여 느린 비동기 컴포넌트를 감싸 초기 페이지 로드를 차단하지 않도록 합니다. 라우트 수준의 스켈레톤 UI에는 **loading.tsx**를 사용합니다. - PPR (부분 사전 렌더링): 단일 HTTP 요청에서 정적 셸과 동적 영역을 결합합니다.
next.config.js에서 **ppr: true**를 활성화합니다. - 전략: SEO(SSG/ISR) vs 상호작용(클라이언트) vs 개인화(SSR)에 따라 렌더링을 선택합니다. **
dynamicParams**를 사용하여 캐시되지 않은 라우트에 대한 폴백 동작을 제어합니다. - 하이드레이션: 초기 렌더링에서 브라우저 전용 값(
window.innerWidth,Date.now())을 사용하지 않음으로써 하이드레이션 오류를 방지합니다.mounteduseEffect 패턴을 사용합니다. - Edge 런타임: 전체 Node.js API가 필요하지 않은 경우, 지연 시간이 짧은 전역 분산 실행을 위해 **
runtime: 'edge'**를 사용합니다.
안티 패턴
page.tsx에서 루트 await 금지: 느린 컴포넌트를<Suspense>로 감싸 스트리밍합니다.- 정적 콘텐츠에 SSR 사용 금지: SSG 또는 ISR을 사용하고, SSR은 진정으로 동적인 데이터를 위해 남겨둡니다.
- 초기 렌더링에서
typeof window사용 금지: 하이드레이션 오류를 방지하기 위해useEffect를 사용합니다.