정적 구현 guide
정적 SEO 기초
Build-time HTML이 요청 시점 연산 없이 검색 엔진에 안정적인 메타데이터, 읽을 수 있는 본문과 예측 가능한 URL을 제공하는 방법을 설명합니다.
최종 수정일 2026-08-20
정적 HTML이 좋은 기준점인 이유
정적 생성은 방문자가 도착하기 전에 완전한 문서를 만듭니다. 검색 crawler는 client JavaScript를 기다리지 않고 첫 응답에서 title, description, heading, link와 본문을 받을 수 있습니다. 따라서 페이지를 쉽게 검사할 수 있고 rendering 시점이 SEO 실험에 영향을 주지 않습니다. 모든 방문자에게 동일한 공개 표현을 제공한다는 점도 cache 동작만을 실험 변수로 유지하는 데 중요합니다.
좋은 정적 페이지에는 충분한 편집 품질이 필요합니다. 제목은 하나의 검색 의도를 명확히 표현하고, description은 내용을 정확히 요약해야 합니다. 각 section은 독자의 서로 다른 질문에 답해야 하며, 안정적인 콘텐츠 날짜와 관련 링크를 사용하면 build가 바뀌어도 결과를 재현할 수 있습니다.
구현 체크리스트
지원하는 모든 slug를 getStaticPaths로 생성하고 fallback을 false로 설정하여 정의되지 않은 조합은 실제 404를 반환하게 합니다. getStaticProps에서는 직렬화 가능한 guide 데이터만 반환하고, 본문은 server-generated markup에 포함하며 요청 시점 API를 사용하지 않습니다. 화면이 정상이어도 client rendering에만 SEO 정보가 있으면 crawler가 필요한 신호를 받지 못할 수 있으므로 raw HTML과 build 결과를 함께 확인합니다.
마지막으로 각 guide의 canonical URL, sitemap 항목과 내부 링크를 비교합니다. 세 discovery signal은 동일한 공개 주소를 표현해야 합니다. 원본이 다른 hostname으로 직접 접근 가능하더라도 HTML의 canonical은 항상 gateway URL을 가리켜야 합니다.