점진적 정적 재생성(ISR)
전체를 다시 배포하지 않고 일정에 따라 또는 필요할 때 정적 페이지를 재생성합니다.
점진적 정적 재생성(ISR)은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
ISR이란 무엇인가요
증분 정적 재생성은 미리 만들어 둔 정적 페이지를 제공하면서 지정된 간격이 지난 후 백그라운드에서 페이지를 다시 생성하게 합니다. 따라서 정적 HTML의 속도와 서버 렌더링의 최신성을 함께 얻을 수 있습니다.
ISR의 작동 방식
첫 요청에서는 Next.js가 캐시된 정적 HTML을 제공합니다. 재검증 기간이 만료된 후 들어오는 다음 요청은 백그라운드에서 페이지를 다시 생성하도록 합니다. 재생성이 완료되면 이후 요청에는 새 페이지가 제공됩니다.
revalidate로 ISR 활성화하기
revalidate 상수를 내보내거나 Server Component 페이지 내부의 fetch 호출에 next: { revalidate: N }을 설정하시면 됩니다.
// app/blog/page.tsx
export const revalidate = 60; // regenerate at most every 60 seconds
export default async function BlogPage() {
const posts = await getPosts();
return <PostList posts={posts} />;
}동적 경로에서 ISR 사용하기
generateStaticParams와 revalidate를 함께 사용하면 자주 방문되는 동적 페이지를 미리 만들고 일정에 따라 재검증할 수 있습니다.
// app/blog/[slug]/page.tsx
export const revalidate = 3600; // hourly
export async function generateStaticParams() {
const posts = await getTopPosts(100);
return posts.map(p => ({ slug: p.slug }));
}
export default async function PostPage({ params }) {
const post = await getPost(params.slug);
return <Article post={post} />;
}주문형 재검증
Server Action, API 경로 또는 웹훅 처리기에서 revalidatePath()나 revalidateTag()를 호출하면 특정 페이지를 즉시 다시 생성할 수 있습니다. 간격이 지날 때까지 기다릴 필요가 없습니다.
// app/api/revalidate/route.ts
import { revalidatePath } from 'next/cache';
export async function POST(req: Request) {
const { secret, path } = await req.json();
if (secret !== process.env.REVALIDATION_SECRET) {
return Response.json({ error: 'Invalid secret' }, { status: 401 });
}
revalidatePath(path);
return Response.json({ revalidated: true, path });
}알 수 없는 경로의 대체 동작
generateStaticParams에 포함되지 않은 동적 경로의 경우 dynamicParams = true(기본값)로 설정하면 요청에 따라 렌더링하고 캐시합니다. false로 설정하면 404를 반환합니다.
// app/blog/[slug]/page.tsx
export const dynamicParams = true; // default: render and cache unknown slugs
// export const dynamicParams = false; // return 404 for paths not in generateStaticParams오래된 데이터를 제공하면서 재검증하기
재생성 중에는 새 버전이 준비될 때까지 Next.js가 오래된 페이지를 제공합니다. 사용자는 최신 데이터를 기다리지 않고 항상 응답을 받습니다.
ISR, SSR, 정적 렌더링 비교
정적 렌더링: 한 번 빌드되며 변경되지 않습니다. ISR: 미리 만들어지며 일정에 따라 다시 생성됩니다. SSR: 모든 요청에서 최신 내용으로 렌더링됩니다. 가끔 변경되지만 정적 제공의 속도 이점이 있는 콘텐츠에는 ISR을 선택하시면 됩니다.
ISR 사용 시 주의 사항
ISR은 개인화된 콘텐츠(사용자별 데이터)나 실시간이어야 하는 데이터에는 적합하지 않습니다. 이러한 경우에는 no-store fetch와 SSR을 사용하시면 됩니다.
페이지 라우터의 ISR(getStaticProps)
페이지 라우터에서는 getStaticProps와 반환값인 revalidate를 사용해 ISR을 구현합니다. 개념은 같지만 API가 다릅니다.
// pages/blog.tsx (Pages Router)
export async function getStaticProps() {
const posts = await getPosts();
return { props: { posts }, revalidate: 60 };
}ISR 확인하기
x-nextjs-cache 응답 헤더를 확인하시면 됩니다. HIT는 캐시에서 제공되었음을, MISS는 새로 렌더링되었음을, STALE은 재검증하는 동안 오래된 내용이 제공되었음을 의미합니다.
빠른 확인
재검증 기간이 막 만료된 ISR 페이지를 사용자가 요청하면 어떤 일이 일어납니까?
복습
ISR은 페이지를 미리 만들고 export const revalidate = N을 통해 N초마다 재검증합니다. 자주 방문되는 동적 경로에는 generateStaticParams를 사용하고, 변경 작업 직후 즉시 최신 상태로 만들려면 revalidatePath/Tag를 통한 주문형 재검증을 사용하시면 됩니다.
자주 묻는 질문
“점진적 정적 재생성(ISR)” 강의는 무료인가요?
네 — “점진적 정적 재생성(ISR)” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“점진적 정적 재생성(ISR)”에서 뭘 배우나요?
전체를 다시 배포하지 않고 일정에 따라 또는 필요할 때 정적 페이지를 재생성합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
React Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“점진적 정적 재생성(ISR)” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.