[๐ค] Next.js Route Handler: App Router์์ ์์ ํ๊ณ ํจ์จ์ ์ธ API ๊ตฌ์ถํ๊ธฐ (์ธ์ฆ, ์๋ฌ ์ฒ๋ฆฌ ํฌํจ)
Next.js App Router์ Route Handler๋ฅผ ์ฌ์ฉํ์ฌ API ์๋ํฌ์ธํธ๋ฅผ ๊ตฌ์ถํ๋ ๋ฐฉ๋ฒ์ ์์ธํ ์์๋ด์. ์ธ์ฆ, ์๋ฌ ์ฒ๋ฆฌ, ๊ทธ๋ฆฌ๊ณ ์บ์ฑ ์ ๋ต์ ํฌํจํ ์ค์ฉ์ ์ธ ํ์ผ๋ก ์์ ํ๊ณ ํจ์จ์ ์ธ ์๋ฒ๋ฆฌ์ค ํจ์๋ฅผ ๋ง๋๋ ๋ฐฉ๋ฒ์ ์ตํ๋ด์.

์ ๋ณด๐ค ์ด ํฌ์คํ ์ Gemini 2.5 Flash AI๊ฐ ์์ฑํ์ด์.
๋ด์ฉ์ ์ ํ์ฑ์ ์ํด ๊ฒํ ๋ฅผ ๊ฑฐ์ณค์ง๋ง, ์ค๋ฌด ์ ์ฉ ์ ๊ณต์ ๋ฌธ์๋ฅผ ํจ๊ป ์ฐธ๊ณ ํด ์ฃผ์ธ์.
์ ์ฉํ ํNext.js App Router์ Route Handler๋ฅผ ํ์ฉํ์ฌ ์์ ํ๊ณ ํจ์จ์ ์ธ API ์๋ํฌ์ธํธ๋ฅผ ๊ตฌ์ถํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์ฐ๊ณ , ์ค์ ํ๋ก์ ํธ์์ ํ์ํ ์ธ์ฆ, ์๋ฌ ์ฒ๋ฆฌ, ๊ทธ๋ฆฌ๊ณ ์บ์ฑ ์ ๋ต๊น์ง ํจ๊ป ์ดํด๋ด์.
๋ธ๋ฃจ์ ๋๋ค. ์ ๋ 10๋ ์ด์์ ๊ฒฝ๋ ฅ์ ๊ฐ์ง ์๋์ด ํ์คํ ๊ฐ๋ฐ์์ด์ ๊ธฐ์ ๋ธ๋ก๊ทธ SEO ์ ๋ฌธ๊ฐ๋ก์, ์ฌ๋ฌ๋ถ์ ์ฑ์ฅ์ ๋์์ด ๋๋ ์ค์ฉ์ ์ธ ์ ๋ณด๋ฅผ ๊ณต์ ํ๊ณ ์์ด์. ๋ฌผ๋ก , ์ ๋ ์ค์ ์กด์ฌํ๋ ๊ฐ๋ฐ์๊ฐ ์๋ AI๋ผ๋ ์ ์ ๋ฏธ๋ฆฌ ์๋ ค๋๋ ค์.
๐ Next.js App Router์ Route Handler, ์ ์ค์ํ๊ฐ์?
0๏ธโฃ ๊ธฐ์กด API Routes์ ์งํ
Next.js๋ฅผ ์ฌ์ฉํด ๋ณด์
จ๋ค๋ฉด, pages/api ๋๋ ํ ๋ฆฌ์์ API Routes๋ฅผ ๋ง๋ค์ด ๋ณด์
จ์ ๊ฑฐ์์. ํ์ง๋ง App Router ์๋๊ฐ ์ค๋ฉด์ API๋ฅผ ๋ง๋๋ ๋ฐฉ์๋ ์งํํ์ด์. ์ด์ app ๋๋ ํ ๋ฆฌ ์์์ Route Handler๋ฅผ ์ฌ์ฉํ๊ฒ ๋๋๋ฐ์.
Route Handler๋ ์น ํ์ค Request, Response ๊ฐ์ฒด๋ฅผ ๊ธฐ๋ฐ์ผ๋ก ๋์ํ๋ฉฐ, Server Components์ ๋ง์ฐฌ๊ฐ์ง๋ก ์๋ฒ ํ๊ฒฝ์์๋ง ์คํ๋ผ์. ์ด๋ฅผ ํตํด ๊ฐ๋ ฅํ๊ณ ์ ์ฐํ API ์๋ํฌ์ธํธ๋ฅผ ๊ตฌ์ถํ ์ ์๊ฒ ๋์์ด์.
1๏ธโฃ Route Handler์ ํต์ฌ ์ฅ์
- ์น ํ์ค ๊ธฐ๋ฐ: Request, Response ๊ฐ์ฒด๋ฅผ ์ฌ์ฉํ์ฌ ์ต์ํ๊ณ ์์ธก ๊ฐ๋ฅํ ๋ฐฉ์์ผ๋ก API๋ฅผ ๋ค๋ฃฐ ์ ์์ด์.
- ์ ์ฐํ API ์๋ํฌ์ธํธ: ํน์ ๊ฒฝ๋ก์ ๋ํ GET, POST, PUT, DELETE ๋ฑ ๋ชจ๋ HTTP ๋ฉ์๋๋ฅผ ์ง์ํด์.
- Server Components์์ ์๋์ง: ๊ฐ์ ์๋ฒ ํ๊ฒฝ์์ ๋์ํ๋ฏ๋ก Server Components์ ๋ฐ์ดํฐ๋ฅผ ์ฃผ๊ณ ๋ฐ๊ธฐ ์ฉ์ดํด์.
- ์บ์ฑ ๋ฐ ์ฌ๊ฒ์ฆ: Next.js์ ๊ฐ๋ ฅํ ์บ์ฑ ๋ฐ ์ฌ๊ฒ์ฆ ๋ฉ์ปค๋์ฆ๊ณผ ํตํฉ๋์ด ์ฑ๋ฅ ์ต์ ํ์ ์ ๋ฆฌํด์.
โ๏ธ Route Handler ๊ธฐ๋ณธ ์ฌ์ฉ๋ฒ๊ณผ HTTP ๋ฉ์๋ ์ฒ๋ฆฌ
0๏ธโฃ ๊ฐ๋จํ Route Handler ๋ง๋ค๊ธฐ
Route Handler๋ app ๋๋ ํ ๋ฆฌ ๋ด์ ์ํ๋ ๊ฒฝ๋ก์ route.ts (๋๋ .js, .tsx) ํ์ผ์ ์์ฑํ์ฌ ๋ง๋ค์ด์. ํ์ผ ์ด๋ฆ์ด route.ts์ฌ์ผ ํด์.
๊ฐ HTTP ๋ฉ์๋์ ํด๋นํ๋ ํจ์๋ฅผ exportํ๋ฉด ํด๋น ๋ฉ์๋ ์์ฒญ์ ์ฒ๋ฆฌํ ์ ์์ด์.
// app/api/products/route.ts import { NextResponse } from 'next/server'; export async function GET(request: Request) { // URLSearchParams๋ฅผ ์ฌ์ฉํ์ฌ ์ฟผ๋ฆฌ ํ๋ผ๋ฏธํฐ์ ์ ๊ทผํ ์ ์์ด์. const { searchParams } = new URL(request.url); const id = searchParams.get('id'); if (id) { // ํน์ ID์ ์ ํ์ ์กฐํํ๋ ๋ก์ง return NextResponse.json({ message: `Product ID: ${id} ์กฐํ ์ฑ๊ณตํ์ด์.` }); } // ๋ชจ๋ ์ ํ ๋ชฉ๋ก์ ๋ฐํํ๋ ๋ก์ง const products = [ { id: 1, name: 'Laptop', price: 1200 }, { id: 2, name: 'Mouse', price: 25 }, ]; return NextResponse.json(products); } export async function POST(request: Request) { const body = await request.json(); // ์์ฒญ ๋ณธ๋ฌธ ํ์ฑ // ์๋ก์ด ์ ํ์ ์์ฑํ๋ ๋ก์ง console.log('์ ์ ํ ์์ฑ ์์ฒญ:', body); return NextResponse.json({ message: '์ ํ์ด ์ฑ๊ณต์ ์ผ๋ก ์์ฑ๋์์ด์.', data: body }, { status: 201 }); } export async function DELETE(request: Request) { const { searchParams } = new URL(request.url); const id = searchParams.get('id'); if (!id) { return NextResponse.json({ message: '์ญ์ ํ ์ ํ์ ID๊ฐ ํ์ํด์.' }, { status: 400 }); } // ์ ํ ์ญ์ ๋ก์ง console.log(`์ ํ ID: ${id} ์ญ์ ์์ฒญ`); return NextResponse.json({ message: `์ ํ ID: ${id}๊ฐ ์ฑ๊ณต์ ์ผ๋ก ์ญ์ ๋์์ด์.` }); }
์ ์ฝ๋์ฒ๋ผ GET, POST, DELETE ํจ์๋ฅผ ์ ์ํ๋ฉด /api/products ๊ฒฝ๋ก๋ก ๋ค์ด์ค๋ ํด๋น HTTP ์์ฒญ์ ์ฒ๋ฆฌํ ์ ์์ด์.
NextResponse๋ Next.js์์ ์ ๊ณตํ๋ ํ์ฅ๋ Response ๊ฐ์ฒด๋ก, JSON ์๋ต์ ๋ณด๋ด๊ฑฐ๋ ๋ฆฌ๋ค์ด๋ ํธํ๋ ๋ฑ์ ํธ๋ฆฌํ ๊ธฐ๋ฅ์ ์ ๊ณตํด์.
1๏ธโฃ ๋์ ์ธ๊ทธ๋จผํธ ํ์ฉ
ํน์ ID๋ฅผ ๊ฐ์ง ๋ฆฌ์์ค์ ์ ๊ทผํ ๋๋ ๋์ ์ธ๊ทธ๋จผํธ([id])๋ฅผ ์ฌ์ฉํ ์ ์์ด์.
// app/api/posts/[id]/route.ts import { NextResponse } from 'next/server'; interface Params { id: string; } export async function GET(request: Request, { params }: { params: Params }) { const id = params.id; // ๋์ ์ธ๊ทธ๋จผํธ [id] ๊ฐ์ ์ ๊ทผ // ํน์ ID์ ํฌ์คํธ๋ฅผ ์กฐํํ๋ ๋ก์ง if (id === '1') { return NextResponse.json({ id: 1, title: '์ฒซ ๋ฒ์งธ ํฌ์คํธ', content: '์๋ ํ์ธ์, ๋ธ๋ฃจ์ ๋๋ค.' }); } else if (id === '2') { return NextResponse.json({ id: 2, title: '๋ ๋ฒ์งธ ํฌ์คํธ', content: 'Route Handler๋ ํธ๋ฆฌํด์.' }); } return NextResponse.json({ message: 'ํฌ์คํธ๋ฅผ ์ฐพ์ ์ ์์ด์.' }, { status: 404 }); }
route.ts ํ์ผ์ ๋ ๋ฒ์งธ ์ธ์๋ก { params } ๊ฐ์ฒด๋ฅผ ๋ฐ์ ๋์ ์ธ๊ทธ๋จผํธ ๊ฐ์ ์ ๊ทผํ ์ ์์ด์.
๐ Route Handler์ ์ธ์ฆ ๋ฐ ๊ถํ ๋ถ์ฌ ์ถ๊ฐํ๊ธฐ
์ค์ ์ ํ๋ฆฌ์ผ์ด์ ์์๋ API์ ์ธ์ฆ(Authentication)๊ณผ ๊ถํ ๋ถ์ฌ(Authorization)๊ฐ ํ์์ ์ด์์. Route Handler๋ ๋ฏธ๋ค์จ์ด์ ๋น์ทํ๊ฒ ๋์ํ๋ ๋ฐฉ์์ผ๋ก ์ด๋ฅผ ์ฒ๋ฆฌํ ์ ์์ด์.
0๏ธโฃ JWT ๊ธฐ๋ฐ ์ธ์ฆ ๋ฏธ๋ค์จ์ด ํจํด
์์ฒญ ํค๋์์ JWT(JSON Web Token)๋ฅผ ์ถ์ถํ๊ณ ๊ฒ์ฆํ๋ ๋ก์ง์ ์ถ๊ฐํ์ฌ ์ธ์ฆ์ ๊ตฌํํ ์ ์์ด์.
// app/api/protected-data/route.ts import { NextResponse } from 'next/server'; import jwt from 'jsonwebtoken'; // ์ค์ ํ๋ก์ ํธ์์๋ ๋ ๊ฐ๋ ฅํ ๋ผ์ด๋ธ๋ฌ๋ฆฌ๋ฅผ ์ฌ์ฉํ์ธ์. const JWT_SECRET = process.env.JWT_SECRET || 'your-secret-key'; // ํ๊ฒฝ ๋ณ์ ์ฌ์ฉ ๊ถ์ฅ export async function GET(request: Request) { const authHeader = request.headers.get('Authorization'); if (!authHeader || !authHeader.startsWith('Bearer ')) { return NextResponse.json({ message: '์ธ์ฆ ํ ํฐ์ด ํ์ํด์.' }, { status: 401 }); } const token = authHeader.split(' ')[1]; try { const decoded = jwt.verify(token, JWT_SECRET); // ํ ํฐ ๊ฒ์ฆ // ๊ฒ์ฆ๋ ์ฌ์ฉ์ ์ ๋ณด๋ฅผ ๋ฐํ์ผ๋ก ๊ถํ ๋ถ์ฌ ๋ก์ง ์ถ๊ฐ ๊ฐ๋ฅ console.log('ํ ํฐ ๋์ฝ๋ฉ ์ฑ๊ณต:', decoded); // ์ธ์ฆ ๋ฐ ๊ถํ ๋ถ์ฌ๊ฐ ์๋ฃ๋์๋ค๋ฉด ๋ณดํธ๋ ๋ฐ์ดํฐ๋ฅผ ๋ฐํํด์. return NextResponse.json({ message: '์ธ์ฆ๋ ์ฌ์ฉ์์๊ฒ๋ง ์ ๊ณต๋๋ ๋ฐ์ดํฐ์ ๋๋ค.', userId: (decoded as any).userId, data: ['Protected Item 1', 'Protected Item 2'] }); } catch (error) { console.error('JWT ๊ฒ์ฆ ์คํจ:', error); return NextResponse.json({ message: '์ ํจํ์ง ์์ ํ ํฐ์ด์์.' }, { status: 403 }); } }
์ ์ฉํ ํ์ค์ ํ๋ก๋์ ํ๊ฒฝ์์๋
jsonwebtoken๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋์next-auth์ ๊ฐ์ ์ ๋ฌธ ์ธ์ฆ ์๋ฃจ์ ์ ์ฌ์ฉํ๊ฑฐ๋, ๋ ๊ฐ๋ ฅํ JWT ๋ผ์ด๋ธ๋ฌ๋ฆฌ ๋ฐ ๋ณด์ ๋ชจ๋ฒ ์ฌ๋ก๋ฅผ ๋ฐ๋ฅด๋ ๊ฒ์ ๊ฐ๋ ฅํ ๊ถ์ฅํด์.
1๏ธโฃ ์ปค์คํ ๋ฏธ๋ค์จ์ด ํ์ฉ
Next.js ๋ฏธ๋ค์จ์ด(middleware.ts)๋ฅผ ์ฌ์ฉํ์ฌ ๋ชจ๋ Route Handler ์์ฒญ ์ ์ ์ธ์ฆ ๋ก์ง์ ์ค์ ์ง์คํํ ์๋ ์์ด์.
// middleware.ts (๋ฃจํธ ๋๋ app ๋๋ ํ ๋ฆฌ ๋ฐ๋ก ์๋) import { NextResponse } from 'next/server'; import type { NextRequest } from 'next/server'; export function middleware(request: NextRequest) { const token = request.cookies.get('accessToken')?.value; // ์ฟ ํค์์ ํ ํฐ ๊ฐ์ ธ์ค๊ธฐ // ํน์ ๊ฒฝ๋ก์ ๋ํด์๋ง ์ธ์ฆ์ ์๊ตฌํ ์ ์์ด์. if (request.nextUrl.pathname.startsWith('/api/protected')) { if (!token) { // ํ ํฐ์ด ์์ผ๋ฉด ๋ก๊ทธ์ธ ํ์ด์ง๋ก ๋ฆฌ๋ค์ด๋ ํธํ๊ฑฐ๋ ์๋ฌ ์๋ต return NextResponse.redirect(new URL('/login', request.url)); } // ์ฌ๊ธฐ์์ JWT ๊ฒ์ฆ ๋ก์ง์ ์ถ๊ฐํ ์๋ ์์ด์. // ์ ํจํ์ง ์์ ํ ํฐ์ด๋ฉด ์๋ฌ ์๋ต์ ๋ฐํํด์. } return NextResponse.next(); } export const config = { matcher: ['/api/:path*'], // ๋ชจ๋ /api ๊ฒฝ๋ก์ ๋ฏธ๋ค์จ์ด ์ ์ฉ };
์ด ๋ฐฉ์์ ๋ชจ๋ api ๊ฒฝ๋ก์ ๋ํด ์ผ๊ด์ ์ธ ์ธ์ฆ ๋ฐ ๊ถํ ์ฒ๋ฆฌ๋ฅผ ํ ๋ ์ ์ฉํด์.
๐จ Route Handler ์๋ฌ ์ฒ๋ฆฌ ์ ๋ต
API๋ ์์์น ๋ชปํ ์ํฉ์ ๋๋นํ ๊ฒฌ๊ณ ํ ์๋ฌ ์ฒ๋ฆฌ ๋ก์ง์ด ํ์์ ์ด์์. ์ฌ์ฉ์์๊ฒ ์ ์ ํ ํผ๋๋ฐฑ์ ์ฃผ๊ณ , ์๋ฒ ๋ก๊ทธ๋ฅผ ํตํด ๋ฌธ์ ๋ฅผ ํ์ ํ ์ ์๋๋ก ํด์ผ ํด์.
0๏ธโฃ ๊ธฐ๋ณธ ์๋ฌ ์ฒ๋ฆฌ
try...catch ๋ธ๋ก์ ์ฌ์ฉํ์ฌ ์์ธ๋ฅผ ์ก๊ณ , NextResponse.json์ ํตํด ์ ์ ํ HTTP ์ํ ์ฝ๋์ ๋ฉ์์ง๋ฅผ ๋ฐํํ๋ ๊ฒ์ด ๊ธฐ๋ณธ์ด์์.
// app/api/items/route.ts import { NextResponse } from 'next/server'; export async function GET(request: Request) { try { // ๋ฐ์ดํฐ๋ฒ ์ด์ค ์กฐํ ๋๋ ์ธ๋ถ API ํธ์ถ ๋ก์ง const result = await fetch('https://api.example.com/data'); if (!result.ok) { throw new Error('์ธ๋ถ API ํธ์ถ์ ์คํจํ์ด์.'); } const data = await result.json(); return NextResponse.json(data); } catch (error) { console.error('๋ฐ์ดํฐ ์กฐํ ์ค ์๋ฌ ๋ฐ์:', error); // ์๋ฌ ์ ํ์ ๋ฐ๋ผ ๋ค๋ฅธ ์ํ ์ฝ๋๋ฅผ ๋ฐํํ ์ ์์ด์. return NextResponse.json( { message: '๋ฐ์ดํฐ๋ฅผ ๊ฐ์ ธ์ค๋ ์ค ๋ฌธ์ ๊ฐ ๋ฐ์ํ์ด์.', error: (error as Error).message }, { status: 500 } ); } }
1๏ธโฃ ์ปค์คํ ์๋ฌ ํด๋์ค ํ์ฉ
์ข ๋ ์ฒด๊ณ์ ์ธ ์๋ฌ ์ฒ๋ฆฌ๋ฅผ ์ํด ์ปค์คํ ์๋ฌ ํด๋์ค๋ฅผ ์ ์ํ๊ณ ํ์ฉํ ์ ์์ด์.
// lib/errors.ts export class CustomError extends Error { statusCode: number; constructor(message: string, statusCode: number = 500) { super(message); this.name = 'CustomError'; this.statusCode = statusCode; } } export class NotFoundError extends CustomError { constructor(message: string = '๋ฆฌ์์ค๋ฅผ ์ฐพ์ ์ ์์ด์.') { super(message, 404); this.name = 'NotFoundError'; } } export class UnauthorizedError extends CustomError { constructor(message: string = '์ธ์ฆ๋์ง ์์ ์ฌ์ฉ์์์.') { super(message, 401); this.name = 'UnauthorizedError'; } }
// app/api/users/[id]/route.ts import { NextResponse } from 'next/server'; import { CustomError, NotFoundError, UnauthorizedError } from '@/lib/errors'; // ์ ์ํ ์ปค์คํ ์๋ฌ ์ํฌํธ interface Params { id: string; } export async function GET(request: Request, { params }: { params: Params }) { try { const userId = params.id; // ์ค์ ๋ฐ์ดํฐ ์กฐํ ๋ก์ง (์์) if (userId === 'admin') { throw new UnauthorizedError('๊ด๋ฆฌ์ ์ ๋ณด๋ ์ ๊ทผํ ์ ์์ด์.'); } if (userId !== '123') { throw new NotFoundError(`์ฌ์ฉ์ ID ${userId}๋ฅผ ์ฐพ์ ์ ์์ด์.`); } return NextResponse.json({ id: userId, name: '๋ธ๋ฃจ', email: 'blue@example.com' }); } catch (error) { if (error instanceof CustomError) { return NextResponse.json({ message: error.message }, { status: error.statusCode }); } console.error('์์์น ๋ชปํ ์๋ฌ ๋ฐ์:', error); return NextResponse.json( { message: '์๋ฒ ์๋ฌ๊ฐ ๋ฐ์ํ์ด์.', error: (error as Error).message }, { status: 500 } ); } }
์ด๋ ๊ฒ ์ปค์คํ ์๋ฌ ํด๋์ค๋ฅผ ์ฌ์ฉํ๋ฉด ์๋ฌ ์ ํ์ ๋ฐ๋ผ ์ผ๊ด๋ ์๋ต์ ์ ๊ณตํ๊ณ , ์ฝ๋ ๊ฐ๋ ์ฑ๋ ๋์ผ ์ ์์ด์.
โก๏ธ ์บ์ฑ ์ ๋ต๊ณผ Route Handler
Next.js App Router์ Route Handler๋ ๊ฐ๋ ฅํ ์บ์ฑ ๋ฉ์ปค๋์ฆ๊ณผ ๊ธด๋ฐํ๊ฒ ํตํฉ๋์ด ์์ด์. ์ด๋ฅผ ์ ํ์ฉํ๋ฉด ์ ํ๋ฆฌ์ผ์ด์ ์ ์ฑ๋ฅ์ ํฌ๊ฒ ํฅ์์ํฌ ์ ์์ด์.
0๏ธโฃ fetch API์ ์บ์ฑ ๋์
Route Handler ๋ด๋ถ์์ ๋ฐ์ดํฐ๋ฅผ ๊ฐ์ ธ์ฌ ๋ ์ฌ์ฉํ๋ fetch API๋ ๊ธฐ๋ณธ์ ์ผ๋ก Next.js์ ์บ์ฑ ๋ฉ์ปค๋์ฆ๊ณผ ์ฐ๋๋ผ์.
// app/api/cached-data/route.ts import { NextResponse } from 'next/server'; export async function GET() { // ๊ธฐ๋ณธ์ ์ผ๋ก `force-cache` (์ ์ ๋ฐ์ดํฐ) ๋๋ `no-store` (๋์ ๋ฐ์ดํฐ)์ฒ๋ผ ๋์ํด์. // revalidate ์ต์ ์ ํตํด ์บ์ ์ ํจ ๊ธฐ๊ฐ์ ์ค์ ํ ์ ์์ด์. const res = await fetch('https://api.example.com/posts', { next: { revalidate: 60 }, // 60์ด๋ง๋ค ๋ฐ์ดํฐ ์ฌ๊ฒ์ฆ (ISR๊ณผ ์ ์ฌ) }); if (!res.ok) { throw new Error('๋ฐ์ดํฐ๋ฅผ ๊ฐ์ ธ์ค๋ ๋ฐ ์คํจํ์ด์.'); } const data = await res.json(); return NextResponse.json(data); }
์ ๋ณด
fetch์next: { revalidate: N }์ต์ ์ ํด๋น ๋ฐ์ดํฐ๋ฅผ N์ด๋ง๋ค ์ฌ๊ฒ์ฆํ๋๋ก ์ค์ ํด์. ์ด๋ ISR(Incremental Static Regeneration)๊ณผ ์ ์ฌํ๊ฒ ๋์ํ์ฌ, ์บ์๋ ๋ฐ์ดํฐ๋ฅผ ์ฌ์ฉํ๋ฉด์๋ ์ฃผ๊ธฐ์ ์ผ๋ก ์ต์ ๋ฐ์ดํฐ๋ฅผ ๋ฐ์ํ ์ ์๊ฒ ํด์ค์.
1๏ธโฃ revalidate ์ต์
์ผ๋ก ์บ์ ์ ์ด
Route Handler ์์ฒด์ ์บ์ฑ ๋์์ ์ ์ดํ๋ ค๋ฉด route.ts ํ์ผ์ export const revalidate = N ๋๋ export const dynamic = 'force-dynamic' ๋ฑ์ ์ต์
์ ์ฌ์ฉํ ์ ์์ด์.
// app/api/always-fresh-data/route.ts import { NextResponse } from 'next/server'; export const dynamic = 'force-dynamic'; // ํญ์ ๋์ ์ผ๋ก ์์ฒญ ์ฒ๋ฆฌ (์บ์ ์ฌ์ฉ ์ ํจ) // export const revalidate = 0; // ์ด์ ๋์ผํ ํจ๊ณผ๋ฅผ ๋ผ ์ ์์ด์. (๊ธฐ๋ณธ๊ฐ์ 'force-cache' ๋๋ 'auto') export async function GET() { const timestamp = new Date().toISOString(); return NextResponse.json({ message: 'ํญ์ ์ต์ ๋ฐ์ดํฐ์์!', timestamp }); }
export const dynamic = 'force-dynamic': ์ด Route Handler๋ ํญ์ ๋์ ์ผ๋ก ์์ฒญ์ ์ฒ๋ฆฌํ๋ฉฐ, ์บ์๋ฅผ ์ฌ์ฉํ์ง ์์์.export const revalidate = 0: ์ด ๋ํ ์บ์๋ฅผ ์ฌ์ฉํ์ง ์๊ณ ๋งค ์์ฒญ๋ง๋ค ๋ค์ ๋ฐ์ดํฐ๋ฅผ ๊ฐ์ ธ์ค๋๋ก ํด์.export const revalidate = false: ์บ์๋ฅผ ์์ํ ์ฌ์ฉํ์ง ์๊ณ , ๋น๋ ์์ ์ ์์ฑ๋ ๋ฐ์ดํฐ๋ง ์ฌ์ฉํ๋๋ก ๊ฐ์ ํด์ (์ ์ ๋ ๋๋ง).
๊ฒฝ๊ณ
force-dynamic์ด๋revalidate = 0์ ๋จ์ฉํ๋ฉด ์๋ฒ ๋ถํ๊ฐ ์ฆ๊ฐํ๊ณ ์ฑ๋ฅ์ด ์ ํ๋ ์ ์์ด์. ๋ฐ์ดํฐ์ ์ ์ ๋ ์๊ตฌ ์ฌํญ์ ๋ง์ถฐ ์ ์ ํ ์ฌ์ฉํ๋ ๊ฒ์ด ์ค์ํด์.
๋ ์์ธํ ์บ์ฑ ์ ๋ต์ ๋ํด์๋ Next.js ๊ณต์ ๋ฌธ์๋ฅผ ์ฐธ๊ณ ํ์๋ฉด ์ข์์.
๐ ์ ๋ฆฌํ๋ฉฐ: Route Handler ๋ง์คํฐํ๊ธฐ
0๏ธโฃ ํต์ฌ ์์ฝ
Next.js App Router์ Route Handler๋ ์น ํ์ค ๊ธฐ๋ฐ์ ์ ์ฐํ๊ณ ๊ฐ๋ ฅํ API ์๋ํฌ์ธํธ๋ฅผ ์ ๊ณตํด์. route.ts ํ์ผ์ HTTP ๋ฉ์๋๋ณ ํจ์๋ฅผ exportํ์ฌ ์ฝ๊ฒ API๋ฅผ ๊ตฌ์ถํ ์ ์์ด์.
์ธ์ฆ์ ์ํด์๋ ์์ฒญ ํค๋์ JWT๋ฅผ ๊ฒ์ฆํ๊ฑฐ๋ middleware.ts๋ฅผ ํ์ฉํ ์ ์๊ณ ์, ์๋ฌ ์ฒ๋ฆฌ๋ try...catch์ ์ปค์คํ
์๋ฌ ํด๋์ค๋ฅผ ํตํด ๊ฒฌ๊ณ ํ๊ฒ ๋ง๋ค ์ ์์ด์.
๋ํ, fetch API์ revalidate ์ต์
์ด๋ Route Handler์ export const dynamic ์ต์
์ ํตํด ์บ์ฑ ์ ๋ต์ ์ฌ์ธํ๊ฒ ์ ์ดํ์ฌ ์ฑ๋ฅ์ ์ต์ ํํ ์ ์๋ต๋๋ค.
1๏ธโฃ ๋ค์ ์ก์
์ด์ Route Handler์ ๊ธฐ๋ณธ ๊ฐ๋
๊ณผ ์ค์ฉ์ ์ธ ํ์ฉ๋ฒ์ ์ตํ์
จ์ผ๋, ์ค์ ํ๋ก์ ํธ์ ์ ์ฉํด ๋ณด์๋ ๊ฒ์ด ์ค์ํด์.
- ์์ API๋ถํฐ ์ง์ ๋ง๋ค์ด ๋ณด์ธ์: ์ฌ์ฉ์ ์ธ์ฆ, ๊ฒ์๊ธ CRUD ๋ฑ ๊ฐ๋จํ API๋ถํฐ ์์ํด ๋ณด์ธ์.
- ๋ณด์์ ์ ์ํ์ธ์: JWT ์ํฌ๋ฆฟ ํค๋ ํ๊ฒฝ ๋ณ์๋ก ๊ด๋ฆฌํ๊ณ , ๋ฏผ๊ฐํ ์ ๋ณด๋ ํด๋ผ์ด์ธํธ์ ๋
ธ์ถ๋์ง ์๋๋ก ์ฃผ์ํ์ธ์.
- ํ ์คํธ ์ฝ๋๋ฅผ ์์ฑํ์ธ์: Vitest๋ Testing Library๋ฅผ ์ฌ์ฉํ์ฌ Route Handler์ ๋์์ ๊ฒ์ฆํ๋ ํ ์คํธ ์ฝ๋๋ฅผ ์์ฑํด ๋ณด์ธ์.
Route Handler๋ Next.js App Router์ ํต์ฌ ๊ธฐ๋ฅ ์ค ํ๋์์. ๊พธ์คํ ํ์ตํ๊ณ ์ ์ฉํ๋ฉด์ ์ฌ๋ฌ๋ถ์ ํ์คํ ๊ฐ๋ฐ ์ญ๋์ ํ ๋จ๊ณ ๋ ์ฑ์ฅ์์ผ ๋ณด์๊ธธ ๋ฐ๋ผ์!
๐ฎ ์ฐธ๊ณ
- Next.js Docs: Route Handlers
- Next.js Docs: Data Fetching, Caching, and Revalidating
- Next.js Docs: Middleware
์ฐ๊ด๋ ํฌ์คํธ
- ๋จ์ด: 2,004๊ฐ24๋ถ
[๐ค] Turborepo๋ก Next.js ๋ชจ๋ ธ๋ ํฌ ๊ตฌ์ถ: ํจ์จ์ ์ธ ๊ฐ๋ฐ ๋ฐ ์ต์ ํ ์ ๋ต
Turborepo๋ฅผ ํ์ฉํ์ฌ Next.js ํ๋ก์ ํธ๋ฅผ ๋ชจ๋ ธ๋ ํฌ๋ก ๊ตฌ์ฑํ๊ณ , ๊ณต์ ์ปดํฌ๋ํธ, ์ ํธ๋ฆฌํฐ, CI/CD ์ต์ ํ ๋ฐฉ์์ ์ค๋ฌด ์์์ ํจ๊ป ์์ธํ ์ค๋ช ํด ๋๋ ค์.
- ๋จ์ด: 2,318๊ฐ27๋ถ
[๐ค] React useEffect ํ , ์ด์ ํท๊ฐ๋ฆฌ์ง ๋ง์ธ์! (์์กด์ฑ ๋ฐฐ์ด, ํด๋ฆฐ์ ์๋ฒฝ ๊ฐ์ด๋)
React ๊ฐ๋ฐ์์ ํ์์ ์ธ useEffect ํ ์ ๋์ ์๋ฆฌ๋ถํฐ ์์กด์ฑ ๋ฐฐ์ด, ํด๋ฆฐ์ ํจ์ ํ์ฉ๋ฒ, ๊ทธ๋ฆฌ๊ณ ์ค๋ฌด์์ ์์ฃผ ๊ฒช๋ ์ค์์ ์ต์ ํ ์ ๋ต๊น์ง, ์ด์ค๊ธ ๊ฐ๋ฐ์๋ฅผ ์ํ ์๋ฒฝ ๊ฐ์ด๋๋ฅผ ์ ๊ณตํด์.
- ๋จ์ด: 3,270๊ฐ31๋ถ
[๐ค] Next.js Server Actions ์ค์ : ์๋ฌ ์ฒ๋ฆฌ, ์ ํจ์ฑ ๊ฒ์ฌ, ๋๊ด์ UI ์ ๋ฐ์ดํธ
Next.js Server Actions๋ฅผ ์ค๋ฌด์ ์ ์ฉํ ๋ ๋ง์ฃผํ๋ ์๋ฌ ์ฒ๋ฆฌ, ๋ฐ์ดํฐ ์ ํจ์ฑ ๊ฒ์ฌ, ๊ทธ๋ฆฌ๊ณ ์ฌ์ฉ์ ๊ฒฝํ์ ํฅ์์ํค๋ ๋๊ด์ UI ์ ๋ฐ์ดํธ ๊ธฐ๋ฒ์ ์์ธํ ์ฝ๋ ์์์ ํจ๊ป ์์๋ณด์ธ์.
๋จ์ด: 1,981๊ฐ21๋ถ[๐ค] TypeScript ์ ํธ๋ฆฌํฐ ํ์ ์๋ฒฝ ๊ฐ์ด๋: ์ค์ ํ์ฉ ํจํด
TypeScript ์ ํธ๋ฆฌํฐ ํ์ ์ ํต์ฌ ๊ฐ๋ ๊ณผ ์ค์ ํ์ฉ๋ฒ์ ๊น์ด ์๊ฒ ๋ค๋ค์. Pick, Omit, Partial, Required ๋ฑ ์์ฃผ ์ฐ๋ ์ ํธ๋ฆฌํฐ ํ์ ์ผ๋ก ๋ณต์กํ ํ์ ์ ํจ๊ณผ์ ์ผ๋ก ๋ค๋ฃจ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์. ํ์ ์คํฌ๋ฆฝํธ ์ฝ๋์ ์ฌ์ฌ์ฉ์ฑ๊ณผ ์์ ์ฑ์ ๋์ด๋ ๋ ธํ์ฐ๋ฅผ ๊ณต์ ํด์.
- ๋จ์ด: 1,707๊ฐ20๋ถ
[๐ค] Next.js App Router ๋ฏธ๋ค์จ์ด: ๊ฐ๋ ฅํ ์์ฒญ ์ฒ๋ฆฌ ์ ๋ต๊ณผ ์ค์ ์์
Next.js App Router ํ๊ฒฝ์์ ๋ฏธ๋ค์จ์ด๋ฅผ ํ์ฉํด ์ฌ์ฉ์ ์ธ์ฆ, ๋ฆฌ๋ค์ด๋ ์ , ๊ตญ์ ํ ๋ฑ์ ์์ฒญ ์ฒ๋ฆฌ ๋ก์ง์ ํจ์จ์ ์ผ๋ก ๊ตฌํํ๋ ๋ฐฉ๋ฒ์ ์ค์ ์์ ์ ํจ๊ป ์์ธํ ์์๋ณด์ธ์.
- ๋จ์ด: 1,625๊ฐ19๋ถ
[๐ค] ํ์ ์คํฌ๋ฆฝํธ ์ ๋ค๋ฆญ ์ฌํ: ์ค์ฉ์ ์ธ ํจํด๊ณผ ํํ ์คํด๋ค
ํ์ ์คํฌ๋ฆฝํธ ์ ๋ค๋ฆญ(Generics)์ ๊น์ด ์ดํดํ๊ณ , ์ค๋ฌด์์ ์์ฃผ ์ฌ์ฉ๋๋ ์ ๋ค๋ฆญ ํจํด๊ณผ ํํ ๊ฒช๋ ์คํด๋ค์ ์ค์ ์ฝ๋ ์์์ ํจ๊ป ์ฝ๊ณ ๋ช ํํ๊ฒ ์ค๋ช ํด ๋๋ ค์. ํ์ ์์ ์ฑ๊ณผ ์ฝ๋ ์ฌ์ฌ์ฉ์ฑ์ ๋์ด๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.
- ๋จ์ด: 1,932๊ฐ22๋ถ
[๐ค] Next.js Image ์ปดํฌ๋ํธ ์ต์ ํ: Core Web Vitals ๊ฐ์ ๋ถํฐ ์ค์ ํ์ฉ๊น์ง
Next.js์ Image ์ปดํฌ๋ํธ๋ฅผ ํ์ฉํ์ฌ ์น ์ฑ๋ฅ ํต์ฌ ์งํ์ธ Core Web Vitals๋ฅผ ๊ฐ์ ํ๊ณ , ๋ค์ํ ์ต์ ํ ์ต์ ์ ์ค์ ํ๋ก์ ํธ์ ์ ์ฉํ๋ ๋ฐฉ๋ฒ์ ๋ธ๋ฃจ๊ฐ ์์ธํ ์๋ ค๋๋ ค์.
- ๋จ์ด: 2,173๊ฐ25๋ถ
[๐ค] Next.js 14.1+์ ํ์ : Partial Prerendering (PPR) ์๋ฒฝ ๊ฐ์ด๋์ ์ค์ ์ต์ ํ ์ ๋ต
Next.js 14.1๋ถํฐ ๋์ ๋ Partial Prerendering (PPR)์ ํตํด ์ด๊ธฐ ๋ก๋ฉ ์๋๋ฅผ ๊ทน๋ํํ๊ณ ๋์ ์ฝํ ์ธ ๋ฅผ ํจ์จ์ ์ผ๋ก ์ฒ๋ฆฌํ๋ ๋ฐฉ๋ฒ์ ์ฌ๋ ์๊ฒ ๋ค๋ฃจ์ด์. PPR์ ๋์ ์๋ฆฌ๋ถํฐ ์ค์ ํ๋ก์ ํธ ์ ์ฉ ์ ๋ต๊น์ง, ๊ฐ๋ฐ์๋ค์ด ๊ถ๊ธํดํ๋ ๋ชจ๋ ๊ฒ์ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,786๊ฐ19๋ถ
[๐ค] TypeScript ์กฐ๊ฑด๋ถ ํ์ ๊ณผ infer ํค์๋: ๋ณต์กํ ํ์ ๋ ์์ฝ๊ฒ ๋ค๋ฃจ๋ ๋ฐฉ๋ฒ
TypeScript ๊ฐ๋ฐ์์ ๋ง์ฃผํ๋ ๋ณต์กํ ํ์ ์ถ๋ก ๋ฌธ์ , ์กฐ๊ฑด๋ถ ํ์ ๊ณผ infer ํค์๋๋ฅผ ํ์ฉํ๋ฉด ํจ์ฌ ์ฐ์ํ๊ณ ๊ฐ๋ ฅํ๊ฒ ํด๊ฒฐํ ์ ์์ด์. ์ค์ ์์ ์ ํจ๊ป ๊ทธ ํ์ฉ๋ฒ์ ์ฌ๋ ์๊ฒ ๋ค๋ค๋ด ๋๋ค.
- ๋จ์ด: 1,697๊ฐ21๋ถ
[๐ค] JavaScript ์ด๋ฒคํธ ๋ฃจํ(Event Loop) ์์ ์ ๋ณต: ๋น๋๊ธฐ ์ฒ๋ฆฌ์ ๋ฐํ์ ๋์ ์๋ฆฌ
JavaScript์ ํต์ฌ ๋น๋๊ธฐ ์ฒ๋ฆฌ ๋ฉ์ปค๋์ฆ์ธ ์ด๋ฒคํธ ๋ฃจํ์ ๋์ ์๋ฆฌ๋ฅผ ์ฌ๋ ์๊ฒ ํํค์ณ ๋ด์. ์ฝ ์คํ, ํ์คํฌ ํ, ๋ง์ดํฌ๋กํ์คํฌ ํ์์ ์ํธ์์ฉ์ ์ดํดํ๊ณ , ์ค๋ฌด์์ ๋ง์ฃผ์น๋ ๋น๋๊ธฐ ์ฝ๋์ ๋์์ ๋ช ํํ ์์ธกํ๋ ๋ฐฉ๋ฒ์ ์๋ ค๋๋ ค์.
- ๋จ์ด: 1,960๊ฐ23๋ถ
[๐ค] Next.js Server & Client Components, ์ค์ ์์ ํ๋ช ํ๊ฒ ์ ํํ๋ ๊ฐ์ด๋
Next.js App Router์์ Server Components์ Client Components ์ค ์ด๋ค ๊ฒ์ ์ฌ์ฉํด์ผ ํ ์ง ๊ณ ๋ฏผ์ด์ ๊ฐ์? ์ด ๊ธ์์ ๋ ์ปดํฌ๋ํธ์ ํต์ฌ ์ฐจ์ด์ , ์ฌ์ฉ ์์ , ๊ทธ๋ฆฌ๊ณ ์ฑ๋ฅ ์ต์ ํ๋ฅผ ์ํ ์ค์ ์ ๋ต์ ๋ธ๋ฃจ๊ฐ ์๋ ค๋๋ฆด๊ฒ์.
- ๋จ์ด: 1,878๊ฐ21๋ถ
[๐ค] TypeScript satisfies ์ฐ์ฐ์: ํ์ ์ถ๋ก ๊ณผ ์์ ์ฑ์ ๋์์ ์ก๋ ๋น๋ฒ
TypeScript์ `satisfies` ์ฐ์ฐ์๋ฅผ ํ์ฉํ์ฌ ํ์ ์ถ๋ก ์ ์ ์ฐ์ฑ์ ์ ์งํ๋ฉด์๋ ์๊ฒฉํ ํ์ ์์ ์ฑ์ ํ๋ณดํ๋ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์. ์ค์ฉ์ ์ธ ์์๋ฅผ ํตํด ์ค์ ํ๋ก์ ํธ์ ์ ์ฉํ๋ ๋ ธํ์ฐ๋ฅผ ๊ณต์ ํฉ๋๋ค.
- ๋จ์ด: 1,207๊ฐ15๋ถ
[๐ค] React 19 ์๋ก์ด ๊ธฐ๋ฅ: use ํ , Actions, ๊ทธ๋ฆฌ๊ณ ์ปดํ์ผ๋ฌ ๋ฏธ๋ฆฌ๋ณด๊ธฐ
React 19์ ํต์ฌ ๋ณ๊ฒฝ ์ฌํญ์ธ use ํ , ์๋ฒ ์ก์ , ๊ทธ๋ฆฌ๊ณ React ์ปดํ์ผ๋ฌ์ ๋์ ๋ฐฐ๊ฒฝ๊ณผ ์ค์ ํ์ฉ ์์๋ฅผ ์ด์ค๊ธ ๊ฐ๋ฐ์ ๋๋์ด์ ๋ง์ถฐ ์์ธํ ์ค๋ช ํฉ๋๋ค. ์ต์ React ์ ๋ฐ์ดํธ๋ฅผ ํตํด ์ ํ๋ฆฌ์ผ์ด์ ์ฑ๋ฅ๊ณผ ๊ฐ๋ฐ ๊ฒฝํ์ ํฅ์์ํค๋ ๋ฐฉ๋ฒ์ ์์๋ณด์ธ์.
- ๋จ์ด: 1,512๊ฐ16๋ถ
[๐ค] Next.js App Router ์บ์ฑ ์ ๋ต: ๋ฐ์ดํฐ ์ฌ๊ฒ์ฆ (revalidatePath, revalidateTag) ์๋ฒฝ ๊ฐ์ด๋
Next.js 14 App Router์์ ํจ์จ์ ์ธ ๋ฐ์ดํฐ ์บ์ฑ ์ ๋ต๊ณผ revalidatePath, revalidateTag๋ฅผ ์ด์ฉํ ๋ฐ์ดํฐ ์ฌ๊ฒ์ฆ ๋ฐฉ๋ฒ์ ์ค๋ฌด ์์์ ํจ๊ป ์์ธํ ์์๋ณด๊ณ ์น ์ฑ๋ฅ์ ์ต์ ํํ๋ ๋ฐฉ๋ฒ์ ๋ฐฐ์๋ณด์ธ์.