# [[Client-Side Routing]]

## 📌 Brief Summary
클라이언트 사이드 라우팅(Client-Side Routing)은 브라우저가 서버로부터 전체 새 페이지를 불러오는 대신, JavaScript를 통해 클라이언트 측에서 동적으로 현재 웹 페이지를 다시 작성하여 화면을 전환하는 탐색 방식입니다 [1]. 주로 싱글 페이지 애플리케이션(SPA)에서 사용되어 빠르고 앱과 같은 매끄러운 사용자 경험을 제공합니다 [2, 3]. React 생태계에서는 React Router가 대표적으로 사용되며 라우팅뿐만 아니라 데이터 패칭과 상태 관리를 조율하는 핵심 역할을 담당합니다 [4].

## 📖 Core Content
* **작동 방식 및 사용자 경험(UX):**
  클라이언트 사이드 라우팅은 초기 HTML 셸을 로드한 이후, 사용자의 탐색 요청 시 서버 요청 없이 브라우저 내에서 JavaScript를 실행하여 UI를 업데이트합니다 [1, 5]. 이러한 방식은 화면 전환 시 전체 페이지 새로고침이 발생하지 않으므로 전환 속도가 즉각적으로 느껴지며, 페이지 탐색 중에도 특정 상태(예: 재생 중인 오디오)를 끊김 없이 유지할 수 있다는 장점이 있습니다 [3].

* **React Router를 활용한 구조화:**
  React 애플리케이션에서는 React Router를 사용하여 복잡한 UI 레이아웃과 계층적 내비게이션 패턴을 선언적으로 구성합니다 [6, 7]. 예를 들어 중첩 라우트(Nested Routes) 기능과 `<Outlet />` 컴포넌트를 사용하면, 헤더나 사이드바 같은 부모 레이아웃을 고정한 상태에서 URL 경로에 따라 내부 자식 컴포넌트만 동적으로 교체할 수 있습니다 [6-8]. 더 나아가 v6.4 이상에서는 `loader`와 `action` API를 제공하여 컴포넌트가 렌더링되기 전에 라우트 수준에서 병렬로 데이터를 가져오거나 폼 제출(Mutation)을 처리할 수 있게 함으로써 성능을 극대화합니다 [9].

* **기술적 SEO 및 크롤링 문제 (CSR의 한계):**
  라우팅을 전적으로 클라이언트 측 JavaScript에 의존하면 검색 엔진 최적화(SEO)에 심각한 문제가 발생할 수 있습니다 [10]. 크롤러는 초기 로드 시 내용이 없는 빈 HTML 셸(`<div id="root"></div>`)만 보게 되며, JavaScript가 실행되어 렌더링될 때까지 콘텐츠 인덱싱이 지연됩니다 [11-13]. 또한 사용자가 존재하지 않는 URL에 접근할 때 브라우저 화면상으로는 "페이지를 찾을 수 없음"을 표시하더라도, 서버는 이미 앱 셸을 성공적으로 전달했으므로 404 상태 코드 대신 200 OK 상태 코드를 반환하는 '소프트 404(Soft 404)' 문제가 발생하여 크롤 예산을 낭비하게 됩니다 [10, 14].

* **성능 및 SEO 최적화 프랙티스:**
  성능 및 검색 엔진 접근성을 향상하기 위해서는 클라이언트 라우팅 구현 시 다음과 같은 지침을 따라야 합니다.
  * **HTML5 History API 사용:** 해시(`#`)가 포함된 라우팅(예: `/#/about`)은 크롤러가 제대로 색인하지 못하므로, 깔끔하고 크롤링 가능한 URL 구조를 보장하는 `BrowserRouter`를 사용해야 합니다 [15-17].
  * **표준 앵커 태그 사용:** 크롤러는 버튼 클릭 등 JavaScript의 이벤트 핸들러(예: `onClick`, `router.push()`)를 통한 이동을 추적하지 않습니다. 따라서 모든 내부 내비게이션은 반드시 표준 `<a href>` 또는 프레임워크가 제공하는 `<Link>` 태그를 사용해야 합니다 [17, 18].
  * **라우트 기반 코드 스플리팅:** 단일 페이지 애플리케이션의 거대한 JS 번들은 'Interaction to Next Paint (INP)' 등 Core Web Vitals 점수를 악화시킵니다 [14, 19]. 이를 방지하기 위해 각 라우트별로 코드를 분할(Code Splitting)하고 지연 로딩(Lazy Loading)을 적용하여 현재 페이지에 필요한 코드만 다운로드되도록 해야 합니다 [19-22].
  * **동적 메타데이터 관리:** 라우트가 변경될 때마다 React Helmet 등의 도구를 사용하여 `<title>`과 메타태그를 동적으로 업데이트해 주어야 합니다 [15, 23].

## 🔗 Knowledge Connections
- **Related Topics:** [[Single Page Applications (SPA)]], [[React Router]], [[Server-Side Rendering (SSR)]], [[Core Web Vitals]], [[Search Engine Optimization (SEO)]]
- **Projects/Contexts:** [[React 기반 싱글 페이지 애플리케이션 개발]], [[기술적 SEO 최적화 및 렌더링 마이그레이션 전략]]
- **Contradictions/Notes:** 클라이언트 사이드 라우팅은 사용자에게 즉각적이고 끊김 없는 탐색 경험(UX)을 제공하여 유리하지만, 크롤러 관점에서는 JavaScript 실행 지연, 소셜 봇의 렌더링 실패, 소프트 404 등 심각한 SEO 한계를 초래합니다 [3, 10, 13]. 따라서 콘텐츠 노출이 중요한 프로덕션 환경에서는 완전한 CSR 라우팅을 피하고 SSR(서버 사이드 렌더링) 또는 SSG(정적 사이트 생성) 기반의 프레임워크(예: Next.js)로 마이그레이션하여 검색 엔진에 완전한 HTML을 제공하는 하이브리드 접근이 권장됩니다 [24-26].

---
*Last updated: 2026-04-26*