GM 오락실
← 개인 공부 · Next/Express
STUDY NOTE · 개념 정리

Next.js App Router 렌더링 정리: 서버 컴포넌트 vs 클라이언트 컴포넌트

Next/Express
App Router에서 컴포넌트는 기본이 서버 컴포넌트다. 서버 컴포넌트는 서버에서만 실행되어 DB나 비밀키에 직접 접근할 수 있고 JS 번들에 포함되지 않는다. 상태, 이펙트, 이벤트 핸들러, 브라우저 API가 필요한 부분만 파일 맨 위에 "use client"를 붙여 클라이언트 컴포넌트로 만든다. 클라이언트 컴포넌트도 첫 화면 HTML은 서버에서 미리 렌더링되고, 브라우저에서 하이드레이션된다.

1. 한눈에 비교

구분서버 컴포넌트클라이언트 컴포넌트
선언기본값 (아무것도 안 붙임)파일 맨 위에 "use client"
실행 위치서버 (요청 시 또는 빌드 시)서버(첫 HTML 생성) + 브라우저(하이드레이션 후 동작)
JS 번들 포함포함 안 됨포함됨
async 컴포넌트, 직접 await가능불가
DB·파일·비밀 환경 변수 접근가능불가 (NEXT_PUBLIC_ 변수만)
useState, useEffect 등 훅불가가능
onClick 등 이벤트 핸들러불가가능
window, localStorage불가가능 (이펙트나 이벤트 안에서)
Context Provider불가가능

2. 렌더링 결과는 무엇인가

서버 컴포넌트는 HTML만 만드는 것이 아니라 RSC Payload라는 직렬화된 컴포넌트 트리를 만든다. 여기에는 서버 컴포넌트의 렌더링 결과, 클라이언트 컴포넌트가 들어갈 자리와 그 JS 파일 참조, 클라이언트 컴포넌트에 넘길 props가 담긴다.

  1. 서버에서 서버 컴포넌트를 렌더링해 RSC Payload를 만든다.
  2. RSC Payload와 클라이언트 컴포넌트로 첫 화면 HTML을 만든다 (클라이언트 컴포넌트도 여기서 한 번 서버 실행).
  3. 브라우저는 HTML을 바로 보여 준다.
  4. RSC Payload로 트리를 맞추고, 클라이언트 컴포넌트의 JS를 받아 하이드레이션해 이벤트가 동작하게 한다.
  5. 이후 페이지 이동 시에는 HTML 대신 새 RSC Payload만 받아 화면을 갱신한다.

"클라이언트 컴포넌트 = 브라우저에서만 렌더링(CSR)"은 흔한 오해다. 클라이언트 컴포넌트도 첫 요청에서는 서버에서 HTML로 렌더링된다. 그래서 렌더링 중에 window를 바로 쓰면 서버 실행 시점에 에러가 난다.

3. 예제: 필요한 곳만 클라이언트로

// app/products/page.tsx — 서버 컴포넌트 (기본값)
import { getProducts } from "@/lib/db";
import AddToCartButton from "./AddToCartButton";

export default async function ProductsPage() {
const products = await getProducts(); // 서버에서 DB 직접 조회
return (
<ul>
{products.map((p) => (
<li key={p.id}>
{p.name} <AddToCartButton productId={p.id} />
</li>
))}
</ul>
);
}
// app/products/AddToCartButton.tsx — 클라이언트 컴포넌트
"use client";
import { useState } from "react";

export default function AddToCartButton({ productId }: { productId: number }) {
const [added, setAdded] = useState(false);
const add = async () => {
await fetch(`/api/cart/${productId}`, { method: "POST" });
setAdded(true);
};
return <button onClick={add} disabled={added}>{added ? "담김" : "담기"}</button>;
}

목록 렌더링과 데이터 조회는 서버에서 끝나고, 브라우저로 가는 JS는 버튼 하나 분량이다. 페이지 전체에 "use client"를 붙였다면 목록 렌더링 코드와 의존 라이브러리까지 모두 번들에 들어간다.

4. 경계 규칙

규칙설명
"use client"는 경계 선언그 파일과 그 파일이 import하는 모듈은 모두 클라이언트 번들에 들어감. 하위 파일마다 붙일 필요 없음
서버 → 클라이언트 import가능. 서버 컴포넌트가 클라이언트 컴포넌트를 렌더링
클라이언트 → 서버 import불가. import하면 그 컴포넌트도 클라이언트 컴포넌트로 취급됨
클라이언트 안에 서버 컴포넌트 넣기children이나 props로 전달하면 가능
서버 → 클라이언트 props직렬화 가능한 값만 (원시값, 일반 객체·배열, Date 등). 일반 함수는 불가 (Server Action은 가능)
// Modal.tsx
"use client";
import { useState } from "react";

export default function Modal({ children }: { children: React.ReactNode }) {
const [open, setOpen] = useState(true);
return open ? <div onClick={() => setOpen(false)}>{children}</div> : null;
}

// page.tsx (서버 컴포넌트)
<Modal>
<CartSummary /> {/* 서버 컴포넌트 그대로 유지 */}
</Modal>

CartSummary는 서버 컴포넌트가 렌더링해서 결과만 Modal에 끼워 넣는다. Modal은 children이 무엇인지 몰라도 된다. 이 "구멍을 뚫어 넘기는" 패턴으로 상호작용 래퍼 안에도 서버 컴포넌트를 유지할 수 있다.

5. 어디에 "use client"를 둘까

  1. 최대한 잎(leaf) 쪽으로: 페이지나 레이아웃 전체가 아니라 버튼, 입력 폼, 탭처럼 상호작용이 있는 작은 단위에 붙인다.
  2. Provider 분리: 테마·장바구니 같은 Context는 클라이언트에서만 동작하므로 Providers.tsx(클라이언트)를 만들고 레이아웃(서버)에서 children을 감싼다.
  3. 서버 전용 코드 보호: DB 접근이나 비밀키를 쓰는 모듈에는 import "server-only";를 넣으면 실수로 클라이언트에서 import할 때 빌드 에러가 난다.
  4. 서드파티 컴포넌트: 훅을 쓰는데 "use client"가 없는 라이브러리 컴포넌트는 직접 클라이언트 파일로 한 번 감싸서 쓴다.

6. 정적 렌더링 vs 동적 렌더링

구분정적 렌더링동적 렌더링
렌더링 시점빌드 시 (또는 재검증 시)요청마다
결과캐시해서 모든 사용자에게 같은 결과요청(쿠키, 헤더, 쿼리)에 따라 다름
전환 조건기본cookies(), headers(), searchParams 같은 요청 정보 사용, 캐시하지 않는 데이터 조회 등

데이터 캐싱과 기본값은 Next.js 버전마다 바뀌어 왔다(예: fetch 결과의 기본 캐시 여부, params 접근 방식). 사용하는 버전의 문서를 기준으로 확인한다. output: "export"로 정적 사이트를 만들면 서버 컴포넌트는 빌드할 때 한 번 실행되고, 요청 시점에 동작해야 하는 기능(쿠키 읽기, Server Action 등)은 쓸 수 없다.

7. 스트리밍

느린 데이터를 기다리느라 페이지 전체가 늦어지지 않도록, 라우트 폴더에 loading.tsx를 두거나 느린 컴포넌트를 <Suspense fallback={...}>로 감싸면 준비된 부분부터 먼저 보내고 나머지는 완료되는 대로 이어서 보낸다.

8. 실제로 어떻게 적용되나

  1. 목록 + 필터 화면: 목록 데이터 조회와 렌더링은 서버 컴포넌트, 필터 입력과 정렬 버튼은 클라이언트 컴포넌트로 나눈다. 필터 값은 URL 쿼리로 관리하면 서버 컴포넌트가 searchParams로 받아 다시 조회할 수 있다.
  2. 기존 CRA·Pages Router 코드 이전: 처음에는 기존 페이지 컴포넌트에 "use client"를 붙여 그대로 옮기고, 이후 데이터 조회 부분을 서버 컴포넌트로 끌어올리며 경계를 잎 쪽으로 내리는 식으로 점진적으로 진행할 수 있다.
  3. hydration mismatch: 서버와 브라우저의 첫 렌더링 결과가 다르면 경고가 난다. Date.now(), Math.random(), localStorage 값을 렌더링 중에 바로 쓰는 경우가 대표적이다. 브라우저 전용 값은 useEffect 이후에 반영한다.
  4. 비밀키 노출 방지: 결제·외부 API 키는 서버 컴포넌트나 Route Handler에서만 쓰고, 클라이언트로는 결과만 넘긴다. NEXT_PUBLIC_이 붙은 환경 변수는 번들에 그대로 들어간다.

9. 면접 질문으로 정리

  1. Q. 서버 컴포넌트와 클라이언트 컴포넌트의 차이는? 서버 컴포넌트는 서버에서만 실행되어 데이터에 직접 접근할 수 있고 JS 번들에 포함되지 않는다. 클라이언트 컴포넌트는 "use client"로 선언하며 상태, 이펙트, 이벤트 처리가 가능하고 번들에 포함되어 하이드레이션된다.
  2. Q. 클라이언트 컴포넌트는 서버에서 렌더링되지 않나? 된다. 첫 요청 시 서버에서 HTML로 미리 렌더링되고, 브라우저에서 하이드레이션되어 상호작용이 가능해진다.
  3. Q. "use client"를 어디에 두는 것이 좋은가? 상호작용이 필요한 가장 작은 컴포넌트에 둔다. 경계 아래의 import는 모두 클라이언트 번들에 들어가므로 상위에 둘수록 번들이 커진다.
  4. Q. 클라이언트 컴포넌트 안에 서버 컴포넌트를 쓸 수 있나? 직접 import하면 클라이언트 컴포넌트가 되지만, 서버 컴포넌트에서 children이나 props로 넘기면 서버 컴포넌트로 유지된다.
  5. Q. 서버 컴포넌트에서 클라이언트 컴포넌트로 함수를 props로 넘길 수 있나? 일반 함수는 직렬화할 수 없어 불가능하다. Server Action으로 정의한 함수는 넘길 수 있다.
Gunmo Lee
since 2021.07
Next.js App Router 렌더링 정리: 서버 컴포넌트 vs 클라이언트 컴포넌트 | GM 오락실