네이버 서치어드바이저 소유권 인증 코드 오혼용 수정
목차
네이버 서치어드바이저 인증 메타태그 값을 올바른 코드로 교체했다.
왜 이런 작업이 생기나
SEO 인프라를 세팅할 때 제일 흔하게 발생하는 실수 중 하나가 바로 사이트 소유권 인증 코드 혼용이다. 네이버 서치어드바이저는 사이트 인증을 위해 <meta name="naver-site-verification" content="..."> 형태의 태그를 <head> 안에 삽입하도록 요구한다. 그런데 이 코드는 서비스 단위로 발급되기 때문에, 여러 프로젝트나 계정을 오가다 보면 엉뚱한 코드가 들어가는 일이 생각보다 자주 발생한다.
이번 경우도 마찬가지였다. Base.astro는 사이트 전체 레이아웃의 베이스가 되는 파일로, 여기 박힌 메타태그는 모든 페이지에 동일하게 적용된다. 즉 이 코드 하나가 잘못돼 있으면 네이버 서치어드바이저에서 소유권 인증 자체가 통과되지 않고, 결과적으로 네이버 웹마스터 도구의 색인 제출, 검색 노출 최적화, 사이트맵 연동 등 SEO 관련 기능을 전혀 활용할 수 없는 상태가 된다.
변경 내용
<!-- Before -->
<meta name="naver-site-verification" content="다른_서비스_용_코드" />
<!-- After -->
<meta name="naver-site-verification" content="money-specific_코드" />
변경 자체는 딱 한 줄, 핀포인트 수정이다. 하지만 이 한 줄이 틀려 있던 기간 동안 네이버 쪽에서는 소유권 미확인 상태로 인식하고 있었다는 게 문제였다.
| 항목 | 변경 전 | 변경 후 |
|---|---|---|
| 인증 코드 | 다른 서비스용 코드 | 해당 서비스 전용 코드 |
| 서치어드바이저 인증 상태 | 실패 / 미확인 | 인증 통과 |
| 영향 범위 | 전체 페이지 | 전체 페이지 |
| 변경 파일 | src/layouts/Base.astro |
동일 |
이런 실수가 생기는 구조적 이유
솔직히 이게 부끄러운 실수처럼 보이지만, 실무에서 꽤 반복되는 패턴이다. 이유를 꼽자면:
- 멀티 프로젝트 관리: 비슷한 구조의 프로젝트를 여럿 만들다 보면 보일러플레이트를 복붙하게 되고, 그 과정에서 인증 코드가 그대로 딸려 온다.
- 코드 리뷰 사각지대:
content값이 긴 해시 문자열이라 리뷰어 입장에서 "이 값이 올바른가"를 한눈에 검증하기 어렵다. 틀려도 코드 자체는 문법적으로 정상이라 린터나 빌드 에러도 안 난다. - 검증이 느리다: 배포하고 나서 서치어드바이저에 들어가 직접 인증을 눌러봐야 틀렸다는 걸 알 수 있다. 즉각적인 피드백이 없다.
이런 이유로 SEO 관련 메타 설정은 배포 체크리스트에 명시적으로 항목을 넣어두는 게 맞다고 본다. 특히 naver-site-verification, google-site-verification 같은 소유권 인증 코드는 환경변수나 설정 파일로 분리해서 관리하면 혼용 위험이 확실히 줄어든다.
// 환경변수로 분리하는 패턴 예시
<meta name="naver-site-verification" content={import.meta.env.NAVER_VERIFICATION_CODE} />
이렇게 하면 코드 리뷰 때 실제 코드값이 소스에 노출되지 않고, 프로젝트마다 다른 값을 .env 파일로 관리할 수 있어서 혼용 사고를 구조적으로 막을 수 있다.
Base.astro 한 파일의 수정이었지만, SEO 파이프라인 전체의 시작점을 잠금 해제한 작업이었다. 작은 chore인데 체감 임팩트는 꽤 크다.
다음엔 소유권 인증 이후 사이트맵 제출 및 색인 현황도 정리해볼 생각이다.
🛒 이 글과 어울리는 추천 상품
*위 링크는 쿠팡파트너스 활동의 일환이며, 일정액의 수수료를 제공받을 수 있습니다.
댓글 0
첫 댓글 달아줘.