App Router (8) - 라우트 세그먼트 옵션, 클라이언트 라우터 캐시

2026.09.26 · 1분 읽기 · 조회 0

라우트 세그먼트 옵션

특정 페이지의 유형을 강제로 Static 또는 Dynamic 페이지로 설정 가능하게 하는 기능이다.

페이지 코드의 가장 위에

export const dynamic = "..."

다음과 같이 적어주면 되는데, 이에는 4가지 옵션이 있다.

auto

export const dynamic = "auto"

기본값, 아무것도 강제하지 않는 옵션이다. 기본적인 페이지의 유형을 결정하는 방식을 따른다.

force-dynamic

export const dynamic = "force-dynamic"

페이지를 강제로 Dynamic 페이지로 설정하는 옵션이다.

force-static

export const dynamic = "force-static"

페이지를 강제로 Static 페이지로 설정하는 옵션이다.

이렇게 설정 시, 쿼리스트링의 같은 동적 함수들은 무조건 undefined가 되며, 데이터 페칭 또한 무조건 force-cache로 설정된다. 때문에 동적 함수에 의존하는 페이지들은 이렇게 설정하지 않는 것에 주의한다.

error

export const dynamic = "error"

페이지를 강제로 Static 페이지로 설정하는 옵션이다. 그러나 동적 함수 사용 등의 이유로 Static페이지로 빌드할 수 없는 경우 오류를 발생시킨다.

클라이언트 라우터 캐시

브라우저에 저장되는 캐시.
페이지 이동을 효율적으로 진행하기 위해 페이지의 일부 데이터를 보관한다.

한 번 접속한 페이지의 레이아웃만 따로 보관해서, 페이지 이동 시 해당하는 페이지의 공통된 레이아웃을 중복 요청하지 않도록 최적화해주는 기능이다. Next에서 기본적으로 제공한다.

댓글

giscus로 동작하며 GitHub Discussions에 저장됩니다.

관련 글