0Pricing
React Academy · 강의

React 서버 컴포넌트 이해하기

RSC가 무엇인지, 클라이언트 컴포넌트와 어떻게 다른지, 각각 언제 사용하는지 알아봅니다.

React 서버 컴포넌트 이해하기은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 수업에서는 React Server Components(RSC)가 무엇인지, 클라이언트 컴포넌트와 어떻게 다른지, 각 유형을 언제 사용해야 하는지 배웁니다.

두 컴포넌트 세계

React 19와 Next.js 앱 라우터는 컴포넌트를 두 세계로 나눕니다. **서버 컴포넌트**는 서버에서 렌더링되고 상호작용이 없으며, **클라이언트 컴포넌트**는 서버와 클라이언트 모두에서 렌더링되고 상태와 이벤트 핸들러를 가집니다.

기본값은 서버 컴포넌트

Next.js 앱 라우터에서는 모든 컴포넌트가 기본적으로 서버 컴포넌트입니다. 파일 맨 위에 'use client'를 추가하면 클라이언트 컴포넌트 모드를 선택할 수 있습니다.
// Server Component (default, no directive needed)
export default async function Page() {
  const data = await fetch('/api/posts').then(r => r.json());
  return <ul>{data.map(p => <li key={p.id}>{p.title}</li>)}</ul>;
}

클라이언트 컴포넌트

파일 맨 위에 'use client'를 추가하면 해당 파일이 클라이언트 컴포넌트가 됩니다. 클라이언트 컴포넌트에서는 useState, useEffect, 이벤트 핸들러, 브라우저 API를 사용할 수 있습니다.
'use client';
import { useState } from 'react';

export function Counter() {
  const [n, setN] = useState(0);
  return <button onClick={() => setN(n+1)}>{n}</button>;
}

서버 컴포넌트의 기능

서버 컴포넌트는 데이터베이스 쿼리를 기다리고, 파일 시스템을 읽고, 환경 비밀 정보에 접근하고, 서버 전용 대형 패키지를 가져오며, 클라이언트로 JavaScript를 전혀 보내지 않고 렌더링할 수 있습니다.
// Fetch from DB directly in the component!
import { db } from '@/lib/db';

export default async function UserList() {
  const users = await db.select().from(usersTable);
  return <ul>{users.map(u => <li key={u.id}>{u.name}</li>)}</ul>;
}

서버 컴포넌트의 제한

서버 컴포넌트는 CANNOT: useState, useEffect, 이벤트 핸들러(onClick 등), 브라우저 API(window, localStorage), Context를 사용할 수 없습니다. 이러한 기능을 사용하려면 'use client'가 필요합니다.

서버 컴포넌트와 클라이언트 컴포넌트 조합

일반적인 패턴은 서버 컴포넌트가 데이터를 가져와 클라이언트 컴포넌트에 속성으로 전달하는 것입니다. 서버는 데이터를 처리하고 클라이언트는 상호작용을 처리합니다.
// Server Component
export default async function Page() {
  const user = await getUser();
  return <ProfileEditor user={user} />; // client component
}

// Client Component (separate file)
'use client';
export function ProfileEditor({ user }) {
  const [name, setName] = useState(user.name);
  return <input value={name} onChange={e => setName(e.target.value)} />;
}

클라이언트 경계 규칙

파일에 'use client'를 표시하면 해당 파일이 가져오는 모든 컴포넌트도 클라이언트 컴포넌트로 처리됩니다. 서버와 클라이언트의 경계는 파일 수준에서 설정됩니다.

서버 컴포넌트에는 JavaScript가 필요하지 않음

서버 컴포넌트는 서버에서 HTML로 렌더링됩니다. 컴포넌트 코드는 NEVER 브라우저로 전송되지 않습니다. 따라서 JavaScript 번들 크기를 크게 줄일 수 있습니다.

서버 컴포넌트와 SSR

기존 SSR은 전체 페이지를 HTML로 렌더링하지만 하이드레이션을 위해 모든 컴포넌트 코드를 클라이언트로 보냅니다. 서버 컴포넌트는 코드를 클라이언트로 전혀 보내지 않고 렌더링된 결과만 보냅니다.

빠른 확인

Next.js 앱 라우터에서 파일을 React 클라이언트 컴포넌트로 만들려면 어떤 지시문을 추가해야 하나요?

복습

서버 컴포넌트는 서버에서 실행되고 데이터베이스와 비밀 정보에 접근하며 클라이언트로 JS를 보내지 않습니다. 클라이언트 컴포넌트는 'use client'를 추가하고 상태, 이펙트, 이벤트 핸들러를 지원합니다. 서버는 데이터를 가져오고 클라이언트는 상호작용하도록 두 컴포넌트를 조합합니다.

다음 학습 내용

다음 수업: **비동기 리소스를 위한 use() 훅** — React 19의 use() 훅으로 렌더링 중 프로미스와 컨텍스트를 읽습니다.

자주 묻는 질문

“React 서버 컴포넌트 이해하기” 강의는 무료인가요?

네 — “React 서버 컴포넌트 이해하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“React 서버 컴포넌트 이해하기”에서 뭘 배우나요?

RSC가 무엇인지, 클라이언트 컴포넌트와 어떻게 다른지, 각각 언제 사용하는지 알아봅니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“React 서버 컴포넌트 이해하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. React 서버 컴포넌트 이해하기
  2. 비동기 리소스를 위한 use() 훅
  3. React 동작과 useActionState
  4. 즉각적인 피드백을 위한 useOptimistic
← React Academy(으)로 돌아가기