Next.js 15 패턴
서버 컴포넌트 vs 클라이언트 컴포넌트
기본값: 서버 컴포넌트
export default async function UsersPage() {
const users = await getUsers();
return <UserList users={users} />;
}
클라이언트 컴포넌트 (필요한 경우)
'use client';
import { useState } from 'react';
export function Counter() {
const [count, setCount] = useState(0);
return <button onClick={() => setCount(c => c + 1)}>{count}</button>;
}
서버 액션
'use server';
import { revalidatePath } from 'next/cache';
import { z } from 'zod';
const CreateUserSchema = z.object({
name: z.string().min(1),
email: z.string().email(),
});
export async function createUser(formData: FormData) {
const validated = CreateUserSchema.safeParse({
name: formData.get('name'),
email: formData.get('email'),
});
if (!validated.success) {
return { error: validated.error.flatten() };
}
const user = await db.insert(users).values(validated.data).returning();
revalidatePath('/users');
return { data: user };
}
데이터 페칭
서버 컴포넌트에서
async function UserProfile({ id }: { id: string }) {
const user = await getUser(id);
if (!user) notFound();
return <Profile user={user} />;
}
로딩 상태 처리
export default function Loading() {
return <UserListSkeleton />;
}
에러 처리
'use client';
export default function Error({
error,
reset,
}: {
error: Error;
reset: () => void;
}) {
return (
<div>
<h2>문제가 발생했습니다</h2>
<button onClick={reset}>다시 시도</button>
</div>
);
}
라우트 핸들러 (API)
import { NextResponse } from 'next/server';
export async function GET() {
const users = await getUsers();
return NextResponse.json(users);
}
export async function POST(request: Request) {
const body = await request.json();
const user = await createUser(body);
return NextResponse.json(user, { status: 201 });
}
메타데이터
import { Metadata } from 'next';
export async function generateMetadata({
params,
}: {
params: { id: string };
}): Promise<Metadata> {
const user = await getUser(params.id);
return {
title: user?.name ?? '사용자',
description: `${user?.name}님의 프로필`,
};
}
병렬 라우트
app/
├── @modal/
│ └── (.)photo/[id]/page.tsx # 가로채기 모달
├── layout.tsx
└── page.tsx
모범 사례
- 서버 컴포넌트 우선 - 필요한 경우에만 'use client' 사용
- 데이터 페칭 위치 통일 - 데이터가 사용되는 곳에서 가져오기
- 서버 액션 사용 - 변이 작업에는 API 라우트 대신 서버 액션 사용
- Suspense로 스트리밍 - 점진적 로딩을 위해 사용
- 모든 입력 검증 - 서버 액션에서 Zod 사용