Next.js

Next.js 블로그 메타데이터 디버깅 순서

검색 엔진이 제목을 제대로 읽고 있는지 확인하는 기본 절차. canonical 태그부터 확인하면 대부분의 SEO 문제를 빠르게 찾을 수 있다.

2026년 6월 22일·1분 읽기

블로그가 검색에 잘 안 띄면 제일 먼저 HTML head를 의심해야 한다. 로컬에서 완벽한데 배포 후 메타데이터가 달라지는 경우가 생각보다 많기 때문이다.

제일 먼저 볼 것: HTML head 태그들

curl -s https://example.com | grep -Ei 'title|description|canonical|og:|twitter:'

이 명령어만으로 대부분의 메타데이터 문제를 잡을 수 있다. 특히 canonical이 이상하면 다른 부분을 아무리 고쳐도 효과가 없다.

로컬 개발 서버는 동적 렌더링이지만, 배포는 정적 생성(SSG)이나 서버 사이드 렌더링(SSR)이다. 그래서 npm run build 후에 결과를 꼭 확인해야 한다.

npm run build
# .next 디렉토리의 생성된 HTML 파일 확인
cat .next/server/pages/some-page.html | head -30

메타데이터가 맞으면 sitemap도 제대로 생성되는지, RSS 피드에는 내 글이 들어가 있는지 확인하자. 이 두 개가 맞아야 검색 엔진과 구독자들이 콘텐츠를 정확히 인식한다.

작은 확인들이 쌓이면 원인 후보가 자연스럽게 줄어든다. 다음에 비슷한 문제가 나면 이 순서대로 하면 된다.