프레임워크와 렌더링 방식: CSR, SSR, SSG
React 같은 프레임워크가 무슨 일을 대신해 주는지, 화면을 언제 어디서 그리느냐에 따라 무엇이 달라지는지 정리해요. 1,000개 목록에서 하나만 바뀌었을 때 처음부터 다시 그리는 방식과 바뀐 것만 고치는 방식의 차이를 실제 브라우저에서 세어 보고, 브라우저에서 그리는 CSR, 요청마다 서버에서 그리는 SSR, 배포할 때 미리 그려 두는 SSG를 비교해요. 자바스크립트를 실행하지 않는 검색 로봇과 링크 미리 보기가 각 방식에서 무엇을 보는지, 첫 화면까지의 시간이 어떻게 달라지는지 계산하고, 내 사이트에 맞는 방식을 고르는 기준까지 다뤄요.
자바스크립트 강의의 할 일 앱은 데이터가 바뀔 때마다 render()로 목록 전체를 처음부터 다시 그렸어요. 할 일 몇 개일 때는 아무 문제가 없지만, 화면이 커지고 바뀌는 곳이 많아지면 두 가지가 힘들어져요. 손으로 DOM을 고치는 코드가 뒤엉키고, 매번 전부 다시 그리느라 느려지는 거예요. 프레임워크는 이 두 문제를 대신 풀어 줘요. 그리고 프레임워크를 쓰기 시작하면 "화면을 언제, 어디서 그릴까"라는 선택이 생겨요. 이 선택이 사이트의 속도와 검색 노출을 크게 바꿔요.
프레임워크가 해 주는 일
React, Vue, Svelte 같은 프레임워크의 공통된 생각은 이거예요. "화면은 데이터를 넣으면 나오는 결과다." 개발자는 "데이터가 이럴 때 화면은 이렇게 생겼다"만 적고, 데이터가 바뀌었을 때 DOM의 어디를 어떻게 고칠지는 프레임워크가 알아서 계산해요. React로 상품 목록을 쓰면 이런 모양이에요.
function ProductList({ items }) {
return (
<ul>
{items.map((item) => (
<li key={item.id}>{item.text}</li>
))}
</ul>
);
}
HTML처럼 보이지만 자바스크립트 안에 쓴 JSX라는 문법이에요. 화면을 컴포넌트라는 부품으로 나누고, 부품은 받은 데이터(props)와 자기 상태(state)로 화면을 그려요. 눈여겨볼 것은 key={item.id}예요. 이 이름표가 왜 중요한지 직접 세어 볼게요.
다시 그리기와 바뀐 것만 고치기
1,000개짜리 목록 두 개를 만들고, 그중 하나만 바꾼 뒤 각 방식이 DOM을 얼마나 건드리는지 세어 볼게요. 브라우저의 MutationObserver는 DOM에 노드가 들어오고 나갈 때마다 알려 줘요. 아무 페이지나 열고 콘솔에 붙여 넣어 보세요.
const makeBox = () => document.body.appendChild(document.createElement("ul"));
const boxAll = makeBox();
const boxKeyed = makeBox();
const counts = new Map([[boxAll, 0], [boxKeyed, 0]]);
for (const box of [boxAll, boxKeyed]) {
new MutationObserver((records) => {
for (const r of records) counts.set(box, counts.get(box) + r.addedNodes.length + r.removedNodes.length);
}).observe(box, { childList: true, subtree: true });
}
const items = Array.from({ length: 1000 }, (_, i) => ({ id: i, text: `상품 ${i}` }));
function renderAll() { // 매번 처음부터 다시 그리기
boxAll.replaceChildren(...items.map((item) => {
const li = document.createElement("li");
li.textContent = item.text;
return li;
}));
}
const nodeById = new Map();
function renderKeyed() { // 이름표(key)로 짝을 맞춰 바뀐 것만 고치기
for (const item of items) {
let li = nodeById.get(item.id);
if (!li) {
li = document.createElement("li");
boxKeyed.append(li);
nodeById.set(item.id, li);
}
if (li.textContent !== item.text) li.textContent = item.text;
}
}
renderAll();
renderKeyed();
await new Promise((r) => setTimeout(r, 0));
counts.set(boxAll, 0);
counts.set(boxKeyed, 0);
items[500].text = "상품 500 (품절)"; // 1000개 중 하나만 바뀌었어요
renderAll();
renderKeyed();
await new Promise((r) => setTimeout(r, 0));
console.log("처음부터 다시 그리기: DOM 노드", counts.get(boxAll), "개를 넣고 뺐어요");
console.log("바뀐 것만 고치기: DOM 노드", counts.get(boxKeyed), "개를 넣고 뺐어요");
console.log("두 목록의 내용이 같은가요?", boxAll.textContent === boxKeyed.textContent);
처음부터 다시 그리기: DOM 노드 2000 개를 넣고 뺐어요
바뀐 것만 고치기: DOM 노드 2 개를 넣고 뺐어요
두 목록의 내용이 같은가요? true
결과 화면은 똑같은데, 처음부터 다시 그리면 1,000개를 빼고 1,000개를 새로 넣어요. 이름표로 짝을 맞춘 쪽은 바뀐 항목의 글자 하나만 갈아 끼웠어요. DOM을 건드리는 일은 브라우저가 다시 배치하고 다시 칠해야 해서 비싸요. 게다가 전부 새로 만들면 입력칸에 치던 글자, 스크롤 위치, 포커스 같은 것들도 사라져요.
React가 하는 일이 바로 이 "짝 맞추기"예요. 새로 그린 화면 설계도와 이전 설계도를 비교해서 바뀐 곳만 실제 DOM에 고쳐요. 목록에서는 무엇이 무엇과 같은 항목인지 알아야 하니 key가 필요해요. 배열의 순서 번호를 key로 쓰면 맨 앞에 항목 하나만 끼워 넣어도 모든 항목의 번호가 밀려서, 프레임워크가 전부 바뀐 것으로 착각해요. 그래서 바뀌지 않는 고유한 값(데이터의 id)을 key로 써요. Svelte나 Solid처럼 비교 없이 바뀐 곳을 바로 고치는 코드를 미리 만들어 두는 프레임워크도 있어요. 방법은 달라도 목표는 같아요.
화면은 언제, 어디서 그릴까
프레임워크로 만든 화면을 사용자에게 보여 주는 방법은 크게 셋이에요.
| 방식 | 언제 어디서 HTML을 만드나 | 어울리는 곳 |
|---|---|---|
| CSR (Client Side Rendering) | 사용자의 브라우저가 자바스크립트로 | 로그인한 뒤에 쓰는 대시보드, 편집기 같은 앱 |
| SSR (Server Side Rendering) | 요청이 올 때마다 서버가 | 사람마다, 때마다 내용이 바뀌는 페이지(검색 결과, 상품 재고) |
| SSG (Static Site Generation) | 배포할 때 한 번 미리 | 블로그, 문서, 소개 페이지처럼 자주 바뀌지 않는 페이지 |
CSR 페이지가 서버에서 오는 모습은 이래요. 본문 자리가 비어 있고, 자바스크립트가 실행되어야 내용이 채워져요.
<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="utf-8">
<title>상품</title>
</head>
<body>
<div id="root"></div>
<script>
const product = { name: "무선 키보드", price: 39000 }; // 실제로는 API에서 받아 와요
const heading = document.createElement("h1");
heading.textContent = product.name;
const price = document.createElement("p");
price.textContent = `${product.price.toLocaleString("ko-KR")}원`;
document.querySelector("#root").append(heading, price);
</script>
</body>
</html>
이 페이지를 브라우저로 열고 콘솔에서 확인하면 내용이 잘 채워져 있어요.
console.log([...document.querySelector("#root").children].map((el) => el.textContent).join(" / "));
무선 키보드 / 39,000원
자바스크립트를 실행하지 않는 손님들
사람의 브라우저는 자바스크립트를 실행하지만, 모든 방문자가 그렇지는 않아요. 카카오톡이나 메신저에 링크를 붙였을 때 제목과 그림을 보여 주는 링크 미리 보기는 대개 서버가 보낸 HTML만 읽어요. 검색 로봇 중에도 자바스크립트를 실행하지 않거나, 실행하더라도 한참 뒤로 미루는 경우가 있어요. 그런 손님의 눈으로 CSR과 SSG 페이지를 읽어 볼게요.
from bs4 import BeautifulSoup
csr_html = """<!DOCTYPE html>
<html lang="ko"><head><meta charset="utf-8"><title>상품</title></head>
<body><div id="root"></div><script src="/app.js"></script></body></html>"""
ssg_html = """<!DOCTYPE html>
<html lang="ko"><head><meta charset="utf-8"><title>무선 키보드 | 우리 가게</title>
<meta name="description" content="소음이 적은 무선 키보드, 39,000원">
<meta property="og:title" content="무선 키보드 39,000원"></head>
<body><div id="root"><h1>무선 키보드</h1><p>39,000원</p></div><script src="/app.js"></script></body></html>"""
for name, html in (("CSR", csr_html), ("SSG", ssg_html)):
soup = BeautifulSoup(html, "html.parser") # 자바스크립트를 실행하지 않는 쪽이 보는 것
og = soup.find("meta", property="og:title")
print(f"{name}: 제목={soup.title.string!r}, 본문={soup.body.get_text(' ', strip=True)!r}, "
f"미리 보기 제목={og['content'] if og else None!r}")
CSR: 제목='상품', 본문='', 미리 보기 제목=None
SSG: 제목='무선 키보드 | 우리 가게', 본문='무선 키보드 39,000원', 미리 보기 제목='무선 키보드 39,000원'
CSR 페이지는 사람에게는 멀쩡해도, 자바스크립트를 실행하지 않는 쪽에서 보면 본문이 텅 빈 "상품" 페이지예요. 링크를 공유하면 미리 보기에 아무것도 안 뜨고, 검색 로봇은 무슨 페이지인지 알기 어려워요. SSR이나 SSG는 HTML 안에 본문과 미리 보기용 정보(og: 메타 태그)가 이미 들어 있어서 누가 읽어도 같아요. 앞 강의의 BeautifulSoup 스크래핑이 어떤 사이트에서는 빈 결과를 내는 이유도 이거예요. 그 사이트가 CSR이라 처음 받은 HTML에는 내용이 없는 거죠.
첫 화면까지 걸리는 시간
세 방식은 내용이 처음 보이기까지 거치는 단계가 달라요. 단순한 모델로 계산해 볼게요. 숫자 자체보다 단계의 순서와 차이를 보세요.
RTT = 0.05 # 왕복 50ms
BANDWIDTH = 1_250_000 # 10Mbps = 초당 1.25MB
def get(size, server_work=0.0): # 요청 하나: 왕복 + 서버 일 + 받는 시간
return RTT + server_work + size / BANDWIDTH
HTML_SHELL, HTML_FULL, JS_BUNDLE = 2_000, 30_000, 500_000
API, RENDER, RUN_JS = 0.20, 0.10, 0.15 # API 응답, 서버 렌더링, JS 실행에 드는 초
js = get(JS_BUNDLE) + RUN_JS
csr_content = get(HTML_SHELL) + js + get(1_000, API)
ssr_content = get(HTML_FULL, API + RENDER)
ssg_content = get(HTML_FULL)
for name, content, ready in (("CSR", csr_content, csr_content),
("SSR", ssr_content, ssr_content + js),
("SSG", ssg_content, ssg_content + js)):
print(f"{name}: 내용이 보이기까지 {content:.2f}초, 눌러서 동작하기까지 {ready:.2f}초")
CSR: 내용이 보이기까지 0.90초, 눌러서 동작하기까지 0.90초
SSR: 내용이 보이기까지 0.37초, 눌러서 동작하기까지 0.97초
SSG: 내용이 보이기까지 0.07초, 눌러서 동작하기까지 0.67초
- CSR은 빈 HTML을 받고, 500KB 자바스크립트를 받아 실행하고, 그제야 API를 불러서 그려요. 단계가 차례로 이어져서 가장 늦어요. 그 대신 한 번 뜨고 나면 페이지를 옮겨 다닐 때 새로 받을 게 적어서 앱처럼 빠르게 움직여요.
- SSR은 서버가 데이터를 모아 HTML을 완성해 보내니 내용이 훨씬 빨리 보여요. 하지만 버튼이 동작하려면 결국 같은 자바스크립트를 받아서, 서버가 그린 HTML에 이벤트를 연결해야 해요. 이 과정을 하이드레이션(hydration, 물을 부어 살려 내기)이라고 해요. 그 전까지는 보이기만 하고 눌러도 반응이 없어요.
- SSG는 HTML이 이미 만들어져 있어서 서버가 생각할 일이 없어요. 파일을 사용자 가까이의 CDN에 두면 왕복 시간까지 줄어서 더 빨라요.
세 방식 모두에서 자바스크립트 양이 "눌러서 동작하기까지"를 좌우해요. 그래서 요즘은 화면에서 실제로 움직이는 부분에만 자바스크립트를 보내는 방식(Astro의 아일랜드, React의 서버 컴포넌트 등)이 쓰여요.
이 가이드북은 어떻게 만들까
지금 읽고 있는 이 가이드북은 Next.js로 만들고, 강의 페이지는 SSG예요. 강의 글은 마크다운 파일로 쓰고, 배포할 때 npm run build가 모든 강의를 HTML 파일로 미리 만들어요. 그래서 페이지가 빠르게 열리고, 자바스크립트를 실행하지 않는 링크 미리 보기나 검색 로봇도 본문을 그대로 읽어요. 강의를 고치면 다시 빌드해서 HTML을 새로 만들어요. 강의는 몇 분 늦게 바뀌어도 괜찮으니 SSG가 잘 맞아요.
Next.js 같은 프레임워크는 페이지마다 방식을 고를 수 있어요. 소개 페이지는 SSG로, 검색 결과는 SSR로, 로그인한 뒤의 설정 화면은 CSR로요. 미리 만들어 두되 정해 둔 시간마다 다시 만드는 방식(ISR)처럼 중간 단계도 있어요.
어떤 방식을 고를까
이 질문들에 차례로 답해 보면 대개 정해져요.
- 검색과 링크 미리 보기에 나와야 하나요? 그렇다면 처음 HTML에 내용이 있어야 해요. SSG나 SSR이에요.
- 내용이 얼마나 자주 바뀌나요? 배포할 때나 하루 몇 번이면 SSG(또는 ISR), 요청마다 달라야 하면 SSR이에요.
- 사람마다 다른 내용인가요? 로그인한 사용자만 보는 화면이라면 검색 노출이 필요 없으니 CSR도 좋아요.
- 서버 비용을 감당할 수 있나요? SSR은 요청마다 서버가 일해요. SSG는 파일만 나눠 주면 돼서 무료 호스팅으로도 충분한 경우가 많아요.
실습
- 목록 예제에서
items.unshift({ id: 1000, text: "새 상품" })로 맨 앞에 항목을 하나 넣으면 두 방식이 각각 몇 개의 노드를 건드리나요?renderKeyed는 새 항목을 어디에 붙이는지도 확인해 보세요. 순서까지 맞추려면 무엇이 더 필요할까요? - 자주 가는 사이트에서
Ctrl+U로 HTML 원문을 열어 보세요. 본문 글이 원문에 들어 있나요, 아니면 빈div만 있나요? 그 사이트는 어떤 방식일까요? - 브라우저 설정에서 자바스크립트를 끄고(개발자 도구의 명령 메뉴에서 "Disable JavaScript") 같은 사이트를 열어 보세요. 무엇이 보이나요?
- 시간 모델에서
JS_BUNDLE을 150KB로 줄이면 세 방식의 숫자가 어떻게 바뀌나요? 가장 크게 좋아지는 건 어느 쪽인가요? - 내가 만들고 싶은 사이트의 페이지 세 개를 골라, 위의 네 질문으로 각각 어떤 방식이 맞을지 정해 보세요.
자주 하는 실수
- 검색에 나와야 하는 페이지를 CSR로만 만든다. 처음 HTML이 비어 있으면 링크 미리 보기와 일부 검색 로봇에게는 빈 페이지예요.
- 목록의
key로 배열 순서 번호를 쓴다. 항목을 끼우거나 지우면 엉뚱한 항목의 상태가 남아요. 데이터의 고유한 id를 써요. - SSR이면 무조건 빠르다고 생각한다. 내용은 빨리 보여도, 자바스크립트가 크면 하이드레이션이 끝날 때까지 눌러도 반응이 없어요.
- 바뀌지 않는 페이지를 요청마다 서버에서 그린다. SSG로 미리 만들면 더 빠르고 비용도 적어요.
- 프레임워크부터 고른다. 페이지마다 필요한 방식이 먼저고, 프레임워크는 그걸 잘 지원하는 걸로 고르면 돼요.
점검 문제
- 프레임워크의 "화면은 데이터를 넣으면 나오는 결과"라는 생각은 어떤 수고를 덜어 주나요?
- 1,000개 목록에서 하나만 바뀌었을 때 처음부터 다시 그리는 방식이 나쁜 이유 두 가지는?
- React 목록에서
key에 배열 순서 번호를 쓰면 안 되는 이유는? - CSR, SSR, SSG는 각각 HTML을 언제, 어디서 만드나요?
- CSR 페이지의 링크를 메신저에 붙이면 미리 보기가 비는 이유는?
- 하이드레이션이란 무엇이고, 그 전에는 어떤 상태인가요?
- 블로그 글, 로그인한 뒤의 대시보드, 재고가 계속 바뀌는 상품 페이지에는 각각 어떤 방식이 어울리나요?
정답
- 데이터가 바뀔 때 DOM의 어디를 어떻게 고칠지 직접 계산하고 조작하는 수고를 덜어 줘요. 개발자는 데이터에 따른 화면 모양만 적으면 돼요.
- DOM을 2,000번 넣고 빼느라 느리고, 새로 만들면서 입력 중인 글자, 스크롤, 포커스 같은 상태가 사라지기 때문이에요.
- 항목을 끼우거나 지우면 순서 번호가 밀려서, 프레임워크가 같은 항목을 다른 항목으로 착각하고 불필요하게 고치거나 엉뚱한 상태를 남기기 때문이에요.
- CSR은 사용자의 브라우저가 자바스크립트로, SSR은 요청이 올 때마다 서버가, SSG는 배포할 때 한 번 미리 만들어요.
- 링크 미리 보기는 대개 자바스크립트를 실행하지 않고 서버가 보낸 HTML만 읽는데, CSR의 처음 HTML에는 본문도
og:메타 태그도 없기 때문이에요. - 서버가 그린 HTML에 자바스크립트로 이벤트와 상태를 연결해 살아 움직이게 하는 과정이에요. 그 전에는 화면이 보이기만 하고 눌러도 반응하지 않아요.
- 블로그 글은 SSG, 대시보드는 CSR, 재고가 계속 바뀌는 상품 페이지는 SSR이나 짧은 주기의 ISR이 어울려요.
다음 강의
이제 화면을 언제 어디서 그릴지 고를 수 있어요. 웹 개발 트랙의 마지막 강의에서는 사이트를 실제로 빠르게 만드는 법을 다뤄요. 속도를 재는 지표, 이미지와 글꼴과 자바스크립트를 줄이는 요령, 그리고 검색 엔진이 내 사이트를 잘 읽고 이해하게 만드는 기본기를 익혀요.