포트폴리오목록으로

Next.js

· Updated

사전 렌더링

  • Next.js는 React의 한계를 극복하기 위해 등장한 프레임워크
  • 브라우저에서만 해석되는 특징으로 인해 검색엔진 최적화 등에 불리한 점을 극복하기 위해 등장

SSR

  • 서버 사이드 렌더링(Server-side Rendering) 기법은 Next.js에서 제공하는 가장 기본적인 사전 렌더링 기법
  • 브라우저의 요청이 있을 때 서버에서 HTML을 완성해서 브라우저로 전달
    • 브라우저의 요청이 있을 때: Next.js로 만든 프로그램이 실행되고 있는 런타임을 의미

SSG

  • 정적 사이트 생성(Static Site Generation) 기법은 정적 서비스에서 많이 사용하는 사전 렌더링 기법
  • 데이터가 변경될 여지가 적은 서비스에서 사용 (ex. 블로그 등)
  • 정적 데이터로 만든 서비스가 구현되면 정적 서비스, 정적 사이트가 됨
  • 데이터가 정적이라는 특성 때문에 SSR과 달리 HTML은 빌드 시점에 완성됨 (HTML로 변환된 글이 빌드된 결과물로 배포됨)

ISR

  • 증분 정적 재생성(Incremental Static Regeneration) 기법은 SSG의 단점을 보완하는 사전 렌더링 기법
  • 정적 사이트로 데이터가 변화할 여지가 적지만 완전히 정적이지만은 않은 경우에 활용 (ex. 게시글 조회수 표현 등)
  • ISR은 SSG와 같이 빌드 시점에 HTML을 만들어냄
  • 이후 지정한 시간이 지나 페이지에 접근하면 서버에서 HTML을 다시 생성함 (일종의 캐싱)
    • 추가 배포 과정 없이도 브라우저에 새로운 HTML을 전달할 수 있음

PPR

  • 부분 사전 렌더링(Partial Prerendering) 기법은 Next.js v14에서 등장
  • 일부분은 쉘로, 일부분은 홀로 렌더링
    • 쉘(Shell): 정적으로 사전에 렌더링되는 영역 (SSG와 같음)
    • 홀(Holes): 동적으로 렌더링되는 영역 (SSR과 같음)

라우팅 기법

Dynamic Routes

  • 동적으로 경로를 지정하는 방식
  • 대괄호로 묶어서 파일 이름([slug].tsx)을 지정하면 그 이름으로 된 변수가 생기고, 그 변수를 단서로 활용하여 페이지를 동적으로 그리는 기법 blog/pages/posts/[id].tsx 파일을 사용하는 동적 라우트 폴더 구조 예

App Router

  • 리액트 서버 컴포넌트(RSC; React Server Component)를 적극적으로 활용하는 라우터
  • 페이지 단위가 아닌 컴포넌트 단위로 서버에서 미리 렌더링 하는 방식을 기본으로 하는 라우터
  • Pages Router pages/blog/index.js 파일을 /blog 주소에 대응시킨 원문 예
  • App Router app/blog/index.js 파일을 /blog 주소에 대응시킨 원문 이미지

Router Groups

  • 경로들을 묶어서 관리하게 만드는 기법
  • 괄호로 감싸서 폴더명을 지으면 그 하위 폴더들(경로들)이 하나의 레이아웃(layout.tsx)을 공유하는 구조 app 폴더 아래 marketing·shop 라우트 그룹과 각 layout·page 파일 구조

데이터 페칭

Route Handlers

  • Pages Router에 있던 API Routers의 App Router 버전
  • app 디렉터리 아래에 있는 어떤 폴더에서건 route라는 이름의 파일이라면 API로 활용될 수 있음
  • API Routes pages/api 디렉터리를 /api 하위 경로에 대응시킨 예
  • Route Handlers app/api/route.ts 파일을 /api 주소에 대응시킨 Route Handler 예
  • Route Handlers app/items/route.ts 파일을 /items 주소에 대응시킨 Route Handler 예
  • route라는 이름으로 만들어진 파일은 GET, POST 같은 HTTP 메서드 이름으로 함수를 정의할 수 있음
    • 이 함수는 API가 호출됐을 때 동작함
  • route.ts
TypeScript

export async function GET() {
  const res = await fetch('https://data.mongodb-api.com/...', {
    headers: {
      'Content-Type': 'application/json',
      'API-Key': process.env.DATA_API_KEY,
    },
  });
  const data = await res.json();
  
  return Response.json({data});
}  

Server Actions

  • 'use server'라는 문장이 있는 스코프의 로직은 서버에서만 동작함 (컴포넌트 안이여도 가능함)

스타일링

TailwindCSS

  • 사전에 정의된 클래스명의 조합으로 스타일을 지정하도록 해주는 라이브러리
  • Next.js는 PostCSS와 함께 사용함
  • 빌드 시점에 사용했던 유틸(클래스명)에 대한 CSS 파일을 생성해 최소한의 CSS 파일로 스타일을 지정할 수 있도록 만들어줌
  • 미리 정해진 클래스명을 조합해서 스타일링함
  • 공식 사이트: https://tailwindcss.com/
privacy.md

개인정보 처리방침

이 사이트는 김상훈의 포트폴리오와 기술 블로그입니다. 회원가입, 댓글, 결제 기능은 제공하지 않습니다.

방문 분석

공식 운영 도메인에서 Google Analytics 4, Vercel Web Analytics와 Speed Insights를 사용해 페이지 방문, 유입 경로와 성능을 확인합니다. 개발·미리보기 환경에는 분석 도구를 활성화하지 않습니다.

Google Analytics는 브라우저 식별을 위해 쿠키를 사용할 수 있으며 페이지 URL, 브라우저·기기 정보와 상호작용을 처리합니다. URL과 입력 내용에 이름, 이메일 등 개인정보를 포함하지 마세요. 이 사이트는 이메일이나 연락처를 분석 이벤트로 직접 전송하지 않습니다.

Vercel 분석 도구는 방문 통계와 로딩·응답 성능을 처리합니다. Google과 Vercel의 실제 보관 기간 및 처리는 각 서비스 설정과 정책에 따릅니다.

외부 콘텐츠와 브라우저 저장

블로그에 포함된 외부 이미지는 해당 이미지 서버에서 불러오며 해당 서버에 접속 정보가 전달될 수 있습니다. 글꼴은 이 사이트 서버에서 제공합니다. 테마 선택은 브라우저 로컬 저장소에 저장됩니다.

문의

이메일로 보낸 내용은 문의에 답변하는 데 사용됩니다. 문의: rlatkdgns042@naver.com

· © 2026 Sanghun Kim