Next.js 16에서 dynamic = 'force-static'이 무시되고 매번 재빌드됩니다

Question

Next.js 16 App Router로 정적 페이지를 만들고 있습니다. 페이지 상단에 export const dynamic = 'force-static'를 명시했는데도 빌드 로그에 매번 (Dynamic) 으로 표시되고 SSR로 동작합니다.

fetch는 { cache: 'force-cache' }로 명시했고, cookies()·headers()는 호출하지 않습니다. 무엇이 페이지를 동적으로 만드는지 모르겠습니다.

김영삼 · Accepted Answer

Next.js 16에서 정적/동적을 결정하는 규칙이 15와 미묘하게 달라졌습니다. 강제 정적이 무시되는 원인은 거의 항상 다음 중 하나입니다.1) 자식 컴포넌트 어딘가에서 동적 API 호출본인 페이지가 아니라 import한 컴포넌트 트리에서 cookies()·headers()·searchParams·noStore()가 한 번이라도 호출되면 페이지 전체가 동적으로 떨어집니다.# 빌드 로그에서 정확한 원인 확인
NEXT_DEBUG=1 npm run build 2>&1 | grep -A 3 "Dynamic API"16부터는 어느 컴포넌트에서 어떤 API를 호출했는지 정확한 위치를 출력합니다.2) fetch 호출이 cache 옵션을 못 받는 케이스16에서 fetch의 기본 캐시 정책이 변경됐습니다. 명시적으로 옵션을 줘야 합니다.// 명시 안 하면 'no-store'로 떨어짐 (16부터)
const data = await fetch(url, {
  cache: 'force-ca

댓글 0