0Pricing
React Academy · 강의

점진적 정적 재생성(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 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. Next.js에서 캐시 옵션과 함께 fetch() 사용하기
  2. unstable_cache와 React cache()
  3. 점진적 정적 재생성(ISR)
  4. 데이터 변형을 위한 서버 동작
← React Academy(으)로 돌아가기