--- id: FE-NEXT-APP-ROUTER-001 category: "10_Wiki/๐Ÿ’ก Topics/AI" confidence_score: 1.0 tags: [nextjs, react, app-router, server-components, ssr, partial-rendering, web-architecture] last_reinforced: 2026-04-26 --- # Next.js App Router Architecture (Next.js ์•ฑ ๋ผ์šฐํ„ฐ ์•„ํ‚คํ…์ฒ˜) ## ๐Ÿ“Œ ํ•œ ์ค„ ํ†ต์ฐฐ (The Karpathy Summary) > "์„œ๋ฒ„ ์ค‘์‹ฌ์˜ ๋ผ์šฐํŒ… ์•„ํ‚คํ…์ฒ˜๋ฅผ ํ†ตํ•ด ํด๋ผ์ด์–ธํŠธ JavaScript ๋ฒˆ๋“ค์„ ์ตœ์†Œํ™”ํ•˜๊ณ , ์„œ๋ฒ„ ์ปดํฌ๋„ŒํŠธ(RSC)๋ฅผ ๊ธฐ๋ฐ˜์œผ๋กœ ๋ฐ์ดํ„ฐ ํŽ˜์นญ๊ณผ ๋ Œ๋”๋ง์˜ ํŒจ๋Ÿฌ๋‹ค์ž„์„ ์žฌ์ •๋ฆฝํ•˜๋ผ" โ€” React Server Components๋ฅผ ๊ธฐ๋ณธ์œผ๋กœ ์ฑ„ํƒํ•˜์—ฌ ์›น ์„ฑ๋Šฅ๊ณผ ๊ฐœ๋ฐœ์ž ๊ฒฝํ—˜์„ ๋™์‹œ์— ํ˜์‹ ํ•œ Next.js์˜ ์ฐจ์„ธ๋Œ€ ๋ผ์šฐํŒ… ์‹œ์Šคํ…œ. ## ๐Ÿ“– ๊ตฌ์กฐํ™”๋œ ์ง€์‹ (Synthesized Content) - **์ถ”์ถœ๋œ ํŒจํ„ด:** "Server-First Rendering and Granular Hydration" โ€” ๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ๋ฅผ ๊ธฐ๋ณธ์ ์œผ๋กœ ์„œ๋ฒ„์—์„œ ๋ Œ๋”๋งํ•˜๊ณ  ํ•„์š”ํ•œ ์ธํ„ฐ๋ž™์…˜ ๋ถ€๋ถ„๋งŒ ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ๋กœ ์„ ์–ธํ•˜์—ฌ, ํด๋ผ์ด์–ธํŠธ๋กœ ์ „์†ก๋˜๋Š” JS ์–‘์„ ํš๊ธฐ์ ์œผ๋กœ ์ค„์ด๋Š” ํŒจํ„ด. - **์ฃผ์š” ํ•ต์‹ฌ ๊ธฐ์ˆ :** - **React Server Components (RSC):** ์„œ๋ฒ„์—์„œ๋งŒ ์‹คํ–‰๋˜์–ด ํด๋ผ์ด์–ธํŠธ ๋ฒˆ๋“ค์— ํฌํ•จ๋˜์ง€ ์•Š๋Š” ์ปดํฌ๋„ŒํŠธ. ์ง์ ‘์ ์ธ DB ์ ‘๊ทผ ๊ฐ€๋Šฅ. - **Streaming & Suspense:** ์ „์ฒด ํŽ˜์ด์ง€๊ฐ€ ์ค€๋น„๋  ๋•Œ๊นŒ์ง€ ๊ธฐ๋‹ค๋ฆฌ์ง€ ์•Š๊ณ , ๋ Œ๋”๋ง๋œ ์กฐ๊ฐ(Chunk)์„ ์ ์ง„์ ์œผ๋กœ ํด๋ผ์ด์–ธํŠธ์— ์ „์†ก. - **Layouts & Nested Routing:** ์ƒํƒœ๋ฅผ ์œ ์ง€ํ•˜๋ฉด์„œ UI์˜ ํŠน์ • ๋ถ€๋ถ„๋งŒ ์—…๋ฐ์ดํŠธํ•˜๋Š” ๊ณ„์ธต์  ๊ตฌ์กฐ ์ง€์›. - **Caching & Revalidation:** ๋ฐ์ดํ„ฐ ์š”์ฒญ์„ ์ž๋™์œผ๋กœ ๋ฉ”๋ชจ์ด์ œ์ด์…˜ํ•˜๊ณ  ์ „๋žต์ ์œผ๋กœ ๊ฐฑ์‹ (ISR ๋“ฑ). - **์˜์˜:** ๊ธฐ์กด Pages Router์˜ ํ•œ๊ณ„๋ฅผ ๋„˜์–ด ๋ณต์žกํ•œ ๋ฐ์ดํ„ฐ ์˜์กด์„ฑ์„ ๊ฐ€์ง„ ๋Œ€๊ทœ๋ชจ ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์—์„œ๋„ ์ตœ์ƒ์˜ LCP์™€ TTI๋ฅผ ๋ณด์žฅํ•จ. ## โš ๏ธ ๋ชจ์ˆœ ๋ฐ ์—…๋ฐ์ดํŠธ (Contradictions & RL Update) - **๊ณผ๊ฑฐ ๋ฐ์ดํ„ฐ์™€์˜ ์ถฉ๋Œ:** ๊ณผ๊ฑฐ Pages Router์—์„œ๋Š” `getServerSideProps`๋ฅผ ํ†ตํ•ด ์ตœ์ƒ๋‹จ์—์„œ๋งŒ ๋ฐ์ดํ„ฐ๋ฅผ ๊ฐ€์ ธ์™”์œผ๋‚˜, App Router ์ •์ฑ…์€ ์ปดํฌ๋„ŒํŠธ ๋ ˆ๋ฒจ์—์„œ ๋น„๋™๊ธฐ(async/await)๋กœ ๋ฐ์ดํ„ฐ๋ฅผ ์ง์ ‘ ํŽ˜์นญํ•˜๋Š” ์ •์ฑ…์œผ๋กœ ์ „ํ™˜๋จ. - **์ •์ฑ… ๋ณ€ํ™”:** Antigravity ํ”„๋กœ์ ํŠธ๋Š” ๋ชจ๋“  ์‹ ๊ทœ ๋Œ€์‹œ๋ณด๋“œ ๋ฐ ์›น ์—”์ง„ ๊ตฌ์ถ• ์‹œ App Router ์•„ํ‚คํ…์ฒ˜๋ฅผ ํ‘œ์ค€์œผ๋กœ ์ฑ„ํƒํ•˜๋ฉฐ, ํด๋ผ์ด์–ธํŠธ ์ปดํฌ๋„ŒํŠธ ์‚ฌ์šฉ์„ ์ตœ์†Œํ™”ํ•˜์—ฌ ์„ฑ๋Šฅ ์ž„๊ณ„์น˜๋ฅผ ๊ด€๋ฆฌํ•จ. ## ๐Ÿ”— ์ง€์‹ ์—ฐ๊ฒฐ (Graph) - [[Web-Rendering-Strategies-CSR-vs-SSR]], Server-Side-Rendering-SSR, React-Architecture, Performance-Optimization - **Raw Source:** 00_Raw/App Router.md