1. SPA와 MPA의 기본 개념
단일 페이지 애플리케이션 (Single Page Application, SPA)
SPA는 단 하나의 HTML 메인 페이지로 구성된 애플리케이션입니다. 초기 실행 시 JavaScript와 CSS 등 필요한 모든 리소스를 한 번에 로드하며, 이후 페이지 이동 시에는 전체를 다시 읽어들이는 대신 필요한 데이터만 가져와서 특정 컴포넌트나 모듈을 교체하는 방식을 취합니다.
다중 페이지 애플리케이션 (Multi-Page Application, MPA)
MPA는 기능이나 서비스마다 독립된 HTML 페이지를 가지는 전통적인 방식입니다. 사용자가 메뉴를 클릭하여 페이지를 이동할 때마다 브라우저는 서버로부터 새로운 HTML과 관련 리소스를 다시 요청하고 전체 페이지를 새로고침합니다.
2. SPA vs MPA 비교 분석
| 항목 | SPA (Single Page Application) | MPA (Multi-Page Application) |
|---|---|---|
| 구조 | 하나의 메인 페이지 + 다수의 UI 컴포넌트 | 서로 독립적인 여러 개의 HTML 페이지 |
| 사용자 경험(UX) | 전환이 매우 빠르고 부드러움 (초기 로딩 최적화 필요) | 페이지 전환마다 깜빡임 발생, 네트워크 속도 영향 큼 |
| 리소스 로드 | 공통 리소스를 최초 1회만 로드 | 페이지를 이동할 때마다 중복된 리소스를 재로드 |
| SEO 대응 | 기본적으로 불리함 (SSR 또는 Prerendering으로 보완) | 검색 엔진 최적화(SEO)에 매우 유리함 |
| 상태 관리 | 전역 변수나 상태 관리 라이브러리(Redux, Pinia 등) 활용 | Cookie, LocalStorage, URL 파라미터 등을 주로 사용 |
| 개발 및 유지보수 | 초기 설계 비용이 높으나 모듈화로 유지보수가 용이함 | 구현이 간단하나 규모가 커지면 중복 코드 관리가 어려움 |
3. SPA의 핵심 기술: 프론트엔드 라우팅
프론트엔드 라우팅의 핵심은 브라우저의 URL 주소를 변경하면서도 서버에 새로운 페이지 요청을 보내지 않고, 클라이언트 사이드에서 화면을 갱신하는 것입니다. 주로 Hash와 History 두 가지 모드가 사용됩니다.
Hash 모드
URL 끝에 #(해시)를 붙여서 경로를 구분하는 방식입니다. 해시 값의 변경은 브라우저가 서버에 HTTP 요청을 보내지 않도록 설계되어 있으며, 이를 감지하는 hashchange 이벤트를 사용하여 뷰를 전환합니다.
// URL의 해시가 바뀔 때마다 실행되는 이벤트 리스너
window.addEventListener('hashchange', (event) => {
const previousRoute = event.oldURL;
const currentRoute = event.newURL;
console.log(`이전 경로: ${previousRoute}`);
console.log(`현재 경로: ${currentRoute}`);
// 여기서 currentRoute에 따라 특정 컴포넌트를 렌더링하는 로직 수행
}, false);
History 모드
HTML5의 History API를 활용하는 방식입니다. pushState와 replaceState 메서드를 통해 해시 없이 깨끗한 URL 구조를 유지하면서 브라우저 히스토리를 관리할 수 있습니다.
주요 API 활용 예시:
// 1. 새로운 히스토리 기록 추가 (새 페이지 이동 효과)
const stateData = { pageId: 101 };
const pageTitle = "상품 상세 페이지";
const targetUrl = "/product/101";
history.pushState(stateData, pageTitle, targetUrl);
// 브라우저 주소창은 /product/101로 변경되지만 서버 요청은 발생하지 않음
// 2. 현재 히스토리 기록 수정
history.replaceState({ updated: true }, "수정된 제목", "/updated-path");
// 3. 뒤로 가기/앞으로 가기 감지
window.onpopstate = (event) => {
if (event.state) {
console.log("저장된 상태 데이터:", event.state);
// 상태 데이터를 기반으로 화면 복구 로직 실행
}
};
History 모드는 URL 형식이 깔끔하지만, 사용자가 주소창에 직접 URL을 입력하고 엔터를 누르거나 새로고침을 할 경우 서버가 해당 경로의 리소스를 찾지 못해 404 에러가 발생할 수 있습니다. 따라서 서버 측에서 모든 요청을 index.html로 리다이렉트해주는 추가 설정이 반드시 필요합니다.