피드로 돌아가기
Dev.toFrontend
원문 읽기
단일 코드베이스 기반 5개 국어 390개 페이지 i18n 라우팅 설계
Serving 78 cards x 5 languages from one codebase: our i18n routing
AI 요약
Context
78장의 카드와 5개 언어를 지원하는 서비스의 다국어 대응 및 SEO 최적화 필요성 대두. 단일 도메인 내에서 수백 개의 URL을 효율적으로 관리하고 검색 엔진의 중복 콘텐츠 판정을 방지해야 하는 과제 직면.
Technical Solution
- URL Path Prefix 방식을 통한 언어 식별 및 Single Source of Truth 기반의 라우팅 구조 설계
- 유지보수 복잡도 감소를 위해 다국어 환경에서도 English Slug를 공통으로 사용하는 Trade-off 선택
- browser language 기반의 Auto-redirect를 제거하여 사용자 제어권 보장 및 URL 기반 상태 관리 구현
- Bidirectional hreflang 태그와 self-referencing canonical 설정을 통한 언어별 독립적 인덱싱 보장
- Route Config 기반의 자동 Sitemap 생성 로직을 구축하여 744개의 Alternate Link 동기화 자동화
- No Trailing-slash 표준화를 통한 Crawl Budget 분산 방지 및 URL 일관성 확보
실천 포인트
1. i18n 라우팅 설계 시 URL Path에 언어 코드를 포함하여 상태를 명시할 것
2. 다국어 페이지 간 hreflang 설정 시 반드시 상호 참조(Bidirectional) 구조를 유지할 것
3. Sitemap을 수동 관리하지 말고 Route Definition에서 자동 생성하는 파이프라인을 구축할 것
4. 언어별 페이지에 각자의 self-referencing canonical 태그를 부여하여 인덱싱 누락을 방지할 것
5. SPA 환경의 SEO 지연을 방지하기 위해 핵심 상세 페이지의 SSR 또는 Pre-rendering 검토할 것