amaranth.log
💻 개발

[기술부채] 클라이언트 사이드 라우팅

☀️
연관 개념
SPA, SEO, SSR, SSG

클라이언트 사이드 라우팅

: 브라우저에서 페이지를 전환할 때 전체 페이지를 다시 불러오지 않고, 현재 로딩된 애플리케이션 내에서 필요한 컴포넌트만 교체하는 방식
 
일반적으로 사용자가 <a> 태그 등을 통해 특정 경로의 페이지로 이동하면, 브라우저는 바뀐 URL에 따라 전체 페이지를 다시 로드하려고 한다.
React Router와 같은 라이브러리를 사용하면 브라우저의 URL을 바꾸면서 실제로 서버에 리소스 요청을 보내지 않는다.
window.history.pushState() 메서드를 사용하여 브라우저 히스토리에 url을 추가하고, 아무런 렌더링을 일으키지 않는다.
대신 라우터는 별도로 현재 URL이 변경되었는지를 감지하고 그 경로에 매핑된 React 컴포넌트를 찾아 렌더링한다.
이렇게 하면 브라우저가 전체 HTML을 다시 불러오지 않아도 새로운 페이지로 이동한 것처럼 보인다.

이 방식이 전체 페이지를 로드하여 렌더링하는 것과 무슨 차이가 있을까?

전체 페이지를 리로드하는 방식(=서버 사이드 라우팅)

  1. 서버에 새로운 HTML 문서를 요청하고, CSS, JS 파일들도 다시 다운로드한다.
  1. 모든 JavaScript 상태(변수, 메모리)가 초기화된다.
  1. HTML 파싱 → CSS/JS 다운로드 → 파싱 → 실행의 전체 프로세스가 반복된다.
    1. *브라우저 렌더링 파이프 라인 관점에서: DOM/CSSOM 트리 생성, JavaScript 다운로드&실행, 렌더 트리 생성, 레이아웃, 페인트, 합성의 모든 과정 반복
  1. 공통 요소 처리에 있어 헤더, 푸터, 네비게이션 등도 매번 다시 렌더링해야 한다.

클라이언트 사이드 라우팅 방식

  1. 서버 요청 없이 이미 로드된 JavaScript를 통해 화면만 변경한다.
  1. 애플리케이션의 전역 상태, Context, Redux 스토어 등이 그대로 유지된다.
  1. 필요한 컴포넌트만 렌더링하기 때문에 훨씬 빠르다.
    1. *브라우저 렌더링 파이프 라인 관점에서: 레이아웃 단계부터 필요한 부분만 다시 실행
  1. 공통 요소는 그대로 두고 변경되는 부분만 교체된다.

단점은 없나?

  1. 초기 로딩 시간 증가: 모든 라우팅 로직과 여러 페이지에 포함된 JavaScript를 한 번에 다운로드 해야 한다. Code Splitting으로 어느정도 해결 가능하지만, 추가적인 설정이 필요하다.
    1. ☀️
      Code Splitting
      : 하나의 큰 JavaScript 번들을 여러 개의 작은 청크로 나누어, 필요한 코드만 필요한 시점에 로드하는 최적화 기법
      • Route-based Code Splitting ← Next.js의 기본 기법
      • Component-based Code Splitting
      • Library-based Code Splitting
  1. SEO 문제: 초기 HTML이 거의 비어있어 검색 엔진 크롤러가 콘텐츠를 제대로 인덱싱하지 못할 수 있다. SSR, SSG로 해결할 수 있다.
  1. JS 의존성: JS가 비활성화되어 있거나 로드 실패 시 앱이 작동하지 않는다.
  1. 브라우저 히스토리 관리 복잡성: 뒤로가기/앞으로 가기를 직접 구현해야 한다. 스크롤 위치 복원 등 세밀한 처리가 필요하고, 새로고침 시 404 에러가 발생할 수 있다.(서버 차원에서 모든 경로에 대해 같은 HTML을 반환하도록 설정 필요)
    1. ⇒ 보통 이런 문제는 라이브러리 수준에서 해결 가능하다.
  1. 메모리 누수 위험: 페이지를 전환해도 이전 페이지의 이벤트 리스너, 타이머 등이 정리되지 않으면 메모리 누수가 발생할 수 있다.(개발자가 명시적으로 cleanup 해야 함)

관련 개념: React의 SPA(Single Page Application)

: HTML 페이지만 서버에서 받아오고, 이후 모든 페이지 전환과 상호작용을 JavaScript로 처리하는 웹 애플리케이션 방식
반대 개념은 MPA(Multiple Page Application)
 

나아가서: Next.js

Next.js는 React SPA의 단점을 보완한 프레임워크이다.
앞서 클라이언트 사이드 라우팅의 단점 중 SEO 문제를 언급했고, 이를 SSR과 SSG로 해결할 수 있다고 했다.
<!-- React SPA: 검색 엔진 크롤러가 보는 것 --> <!DOCTYPE html> <html> <body> <div id="root"></div> <!-- 콘텐츠가 없음! JavaScript 실행 전까지는 빈 페이지 --> <script src="/bundle.js"></script> </body> </html>
검색 엔진 크롤러가 이 페이지를 방문하면, JavaScript가 실행되기 전의 빈 페이지만 읽게 되어 검색 결과에 제대로 노출되지 않을 수 있다.

SSR(Server Side Rendering)

Next.js의 SSR 방식은 서버에서 미리 HTML을 완성해서 보내준다.
  • SSR의 동작 과정
      1. 사용자가 /products/123 요청
      1. Next.js 서버가 요청을 받음
      1. getServerSideProps 실행 → API에서 데이터 가져옴
      1. React 컴포넌트를 서버에서 렌더링 → 완성된 HTML 생성
      1. 완성된 HTML을 클라이언트에 전송
      1. 브라우저가 즉시 콘텐츠 표시
      1. JavaScript 로드 후 "Hydration" → SPA처럼 동작
  • 장단점
    • 장점
      • SEO 문제가 해결됨
      • 초기 콘텐츠 표시가 빠르다
      • 소셜 미디어 공유 시 미리보기가 정상적으로 작동한다.
    • 단점
      • 매 요청마다 서버에서 렌더링되어 부하가 생길 수 있다
      • TTFB가 느릴 수 있다.(브라우저가 서버에 요청을 보낸 후, 서버로부터 첫 번째 바이트의 데이터를 받기까지 걸리는 시간)
// pages/products/[id].js - Next.js SSR export async function getServerSideProps(context) { const { id } = context.params; // 서버에서 데이터를 미리 가져옴 const product = await fetch(`https://api.example.com/products/${id}`).then(r => r.json()); return { props: { product } }; } function ProductPage({ product }) { return ( <div> <h1>{product.name}</h1> <p>{product.description}</p> <p>Price: ${product.price}</p> </div> ); } export default ProductPage;
<!-- 검색 엔진 크롤러가 받는 HTML (SSR) --> <!DOCTYPE html> <html> <body> <div id="__next"> <div> <h1>iPhone 15 Pro</h1> <p>최신 A17 Pro 칩 탑재</p> <p>Price: $999</p> </div> </div> <!-- 콘텐츠가 이미 있음! --> <script src="/_next/static/chunks/..."></script> </body> </html>

SSG(Static Site Generation)

Next.js의 SSG 방식은 빌드 시점에 미리 HTML을 생성한다.
// pages/blog/[slug].js - Next.js SSG export async function getStaticPaths() { // 빌드 시 생성할 모든 경로 지정 const posts = await fetch('https://api.example.com/posts').then(r => r.json()); const paths = posts.map(post => ({ params: { slug: post.slug } })); return { paths, // [{ params: { slug: 'first-post' }}, ...] fallback: false }; } export async function getStaticProps(context) { const { slug } = context.params; // 빌드 시점에 데이터 가져옴 const post = await fetch(`https://api.example.com/posts/${slug}`).then(r => r.json()); return { props: { post }, revalidate: 60 // ISR: 60초마다 재생성 }; } function BlogPost({ post }) { return ( <article> <h1>{post.title}</h1> <div>{post.content}</div> </article> ); } export default BlogPost;
  • SSG 동작 과정
    • [빌드 시점]
      1. npm run build 실행
      1. getStaticPaths로 모든 경로 파악
      1. 각 경로마다 getStaticProps 실행 → 데이터 가져옴
      1. HTML 파일 미리 생성
          • /blog/first-post.html
          • /blog/second-post.html
          • /blog/third-post.html
      [런타임 - 사용자 요청 시]
      1. 사용자가 /blog/first-post 요청
      1. 이미 생성된 HTML 파일 즉시 반환
      1. 매우 빠른 로딩!
  • 장단점
    • 장점
      • SEO 문제가 해결됨
      • 정적 파일 서빙으로 로딩 속도가 가장 빠르다
      • 서버 부하 거의 없음
      • CDN 캐싱에 최적화되어 있음
    • 단점
      • 데이터가 변경될 때마다 재빌드해야 한다.
      • 동적 컨텐츠에는 부적합하다.
 
📚 기술 부채25 / 31
  1. 1편[기술부채] 우테코 5기 레벨1 - 6주차: 블랙잭 미션, RDD와 try-with-resources2023년 3월 20일
  2. 2편[기술부채] 우테코 5기 레벨1 - 7주차: 체스 미션, 방어적 복사와 커맨드 패턴2023년 3월 27일
  3. 3편[기술부채] 우테코 5기 레벨1 - 8주차: 체스 미션, 테스트 더블과 커넥션 풀2023년 4월 14일
  4. 4편[기술부채] 우테코 5기 레벨2 - 1주차: 웹 자동차 경주, 스프링 MVC 매핑과 DI2023년 4월 16일
  5. 5편[기술부채] 우테코 5기 레벨2 - 2주차: @Valid와 Dirty Checking2023년 5월 1일
  6. 6편[기술부채] 우테코 5기 레벨2 - 3주차: 장바구니 미션, MockMvc vs RestAssured와 PRG 패턴2023년 5월 3일
  7. 7편[기술부채] 우테코 5기 레벨2 - 5주차: Mockito와 동적 쿼리2023년 5월 14일
  8. 8편[기술부채] 우테코 5기 레벨2 - 6주차: 지하철 미션, Profile과 JPA 연관관계2023년 5월 23일
  9. 9편[기술부채] 우테코 5기 레벨2 - 9주차: CORS Preflight와 멱등성, 필드 주입2023년 6월 12일
  10. 10편[기술부채] 우테코 5기 레벨2 - 8주차: 장바구니 협업 미션, LocalDateTime 직렬화와 시맨틱 버저닝2023년 6월 12일
  11. 11편[기술부채] 우테코 5기 레벨2 - 7주차: OSIV와 영속성 컨텍스트, CORS 인증2023년 6월 30일
  12. 12편[기술부채] 우테코 5기 레벨3 - 3주차: 오프셋·커서 페이지네이션과 @ElementCollection2023년 7월 18일
  13. 13편[기술부채] 우테코 5기 레벨3 - 7주차: Batch Insert와 @EventListener2023년 8월 12일
  14. 14편[기술부채] 우테코 5기 레벨3 - 8주차: JPQL Distinct와 MultipleBagFetchException2023년 8월 31일
  15. 15편[기술부채] 우테코 5기 레벨3 - 6주차: 동시성 이슈와 @Transient2023년 8월 31일
  16. 16편[기술부채] 우테코 5기 레벨3 - 1주차: 무결성과 정합성, Elastic Beanstalk2023년 8월 31일
  17. 17편[기술부채] 우테코 5기 레벨4 - 1주차: @TransactionalEventListener와 트랜잭션 전파2023년 9월 10일
  18. 18편[기술부채] 우테코 5기 레벨4 - 2주차: 톰캣 만들기와 Location 헤더2023년 9월 11일
  19. 19편[기술부채] 우테코 5기 레벨4 - 3주차: 로드밸런서, CQRS와 커버링 인덱스2023년 9월 18일
  20. 20편[기술부채] 우테코 5기 레벨4 - 4주차: @MVC 구현하기 미션2023년 9월 24일
  21. 21편[기술부채] 우테코 5기 레벨4 - 5주차: @MVC 구현하기 3단계와 JSON 응답2023년 10월 2일
  22. 22편[기술부채] 우테코 5기 레벨4 - 6주차: JDBC 라이브러리 구현하기 1~3단계2023년 10월 9일
  23. 23편[기술부채] 우테코 5기 레벨4 - 7주차: JDBC 라이브러리 구현하기 3단계2023년 10월 16일
  24. 24편[Spring] Spring DTO의 데이터 바인딩과 직렬화2023년 12월 5일
  25. 25편[기술부채] 클라이언트 사이드 라우팅2026년 2월 5일
  26. 26편[기술부채] 왜 리액트는 클래스를 버리고 함수를 선택했을까(feat. React Hooks)2026년 2월 12일
  27. 27편[기술부채] iframe과 postMessage2026년 2월 20일
  28. 28편[기술부채] Service Worker(서비스 워커)2026년 2월 24일
  29. 29편[기술부채] 커링의 어원과 함수형 프로그래밍2026년 3월 12일
  30. 30편[기술부채] AG-UI와 CopilotKit - 12026년 3월 27일
  31. 31편[기술부채] AG-UI와 CopilotKit - 22026년 3월 29일