Rank Math 사이트맵 404와 메타 태그 누락 해결

Rank Math 를 쓰는 워드프레스에서 사이트맵 주소가 404였고, 다른 사이트에서는 메타 태그가 절반도 안 나왔습니다. 둘 다 플러그인은 켜져 있었습니다. 실제로 원인이 된 것과 헛다리였던 것을 나눠 적습니다.

켜져 있는데 출력이 없다

증상	원인	해결
sitemap_index.xml 과 wp-sitemap.xml 이 둘 다 404	rewrite 규칙표에 사이트맵 규칙 없음	rewrite flush
고유주소를 바꾼 뒤 사이트맵이 잠시 404	규칙표가 깨짐	flush 두 번
사이트맵은 열리는데 새 글이 빠져 있음	사이트맵 파일 캐시가 안 비워짐	캐시 비우기
프런트 메타 태그 4개뿐	rank_math_registration_skip 옵션 없음	옵션 추가

워드프레스 기본 사이트맵인 wp-sitemap.xml 도 404였던 것은 Rank Math 가 기본 사이트맵을 대체하면서 꺼 두기 때문입니다.

규칙 미등록과 마법사 미완료

첫째, 사이트맵 모듈은 켜져 있는데 rewrite 규칙표에 sitemap_index\.xml 규칙이 등록되지 않았습니다. 규칙이 없으니 워드프레스가 그 주소를 모르는 페이지로 처리합니다.

둘째, 메타 태그 문제는 메타 태그가 제대로 나오는 다른 워드프레스와 견줘서 찾았습니다. 정상 쪽은 15개, 문제 쪽은 4개였습니다. 두 설치본의 Rank Math 옵션을 나란히 놓으니 rank_math_registration_skip 이 한쪽에만 없었습니다. 이 옵션이 없으면 Rank Math 가 설치 마법사를 끝내지 않은 것으로 보고 프런트 출력을 멈춥니다.

순서대로 해 볼 명령

1. 규칙을 다시 씁니다. Rank Math 가 init 단계에서 규칙을 다시 등록해 바로 200이 됐습니다. 고유주소를 바꾼 뒤라면 두 번 돌립니다.

wp rewrite flush --hard
wp rewrite flush

2. 메타 태그가 적게 나오면 옵션을 넣습니다. 되돌릴 때는 wp option delete 로 지웁니다.

wp option update rank_math_registration_skip 1

3. 사이트맵은 열리는데 새 글이 빠져 있으면 사이트맵 캐시를 비웁니다. 2026년 10월에 실제로 겪었습니다. wp-cli 로 올린 글이 하루가 지나도 사이트맵에 들어가지 않았고, 서치콘솔에서도 구글이 그 글들을 모르는 상태였습니다. Rank Math 는 만든 사이트맵을 wp-content/uploads/rank-math/ 폴더에 파일로 보관하는데, 명령줄로 올린 글로는 이 파일이 다시 만들어지지 않았습니다.

ls -la wp-content/uploads/rank-math/
wp eval 'RankMath\Sitemap\Cache::invalidate_storage();'
curl -s https://example.com/post-sitemap.xml | grep -c '<loc>'

캐시를 비우자 마지막 줄의 숫자가 공개한 글 수에 맞게 늘었습니다. wp-cli 로 글을 올린다면 그 뒤에 비우기 한 줄을 붙여 두고, 서치콘솔에 사이트맵을 다시 제출합니다.

wp-cli 로 옵션만 넣어서는 사이트맵이 안 생기고, 관리 화면의 Rank Math 사이트맵 설정에 한 번 들어가야 활성되는 경우도 있었습니다.

그래도 안 될 때: 주소 출처를 바꾼다

호스팅 업체가 서버를 관리해 주는 곳에서는 flush 를 해도 계속 404가 나거나, 200인데 XML이 아니라 일반 HTML이 왔습니다. 플러그인과 옵션은 정상이었고, 원인은 끝내 확인하지 못했습니다. Rank Math 공식 문서는 이런 경우 nginx 에 사이트맵 rewrite 규칙을 따로 넣거나 캐시 플러그인에서 사이트맵 주소를 빼라고 안내합니다. 저는 그 두 가지까지는 시험하지 못했습니다.

사이트맵이 꼭 필요한 이유가 공개 글 주소 목록이라면, 워드프레스에서 바로 뽑으면 됩니다. 사이트맵이 안 열리던 곳에서도 이 방법으로는 주소 목록을 바로 얻었습니다.

wp post list --post_type=post,page --post_status=publish --field=url --skip-themes

이런 목록을 스크립트로 쓴다면 0건일 때 반드시 경고를 내게 합니다. 사이트맵이 비어도 오류가 나지 않아 "0개 처리"로 조용히 넘어갔기 때문입니다.

고쳐졌는지 확인하는 법

• 쿼리 문자열 없는 주소로 사이트맵을 받아 200인지, 내용이 XML인지 봅니다.
• 메타 태그는 CLI가 아니라 실제 프런트 페이지를 받아 셉니다. wp eval 로 wp_head 훅을 세면 정상 사이트도 0이 나와 판별이 안 됩니다.
• 잘 되는 사이트가 같은 호스팅에 있으면 옵션 목록을 나란히 견줍니다.

curl -sI https://example.com/sitemap_index.xml
curl -sL https://example.com/ | grep -oE '<meta (name|property)="(description|robots|og:|twitter:)[^"]*"' | wc -l
wp option list --search=rank_math*

둘째 줄은 Rank Math 가 내는 설명, 로봇, 공유용 태그만 셉니다. 이 사이트 첫 화면은 지금 11개가 나옵니다. 몇 개가 정상인지는 설정마다 다르므로, 숫자 하나만 보지 말고 잘 되는 페이지와 견줍니다.

404 문제에서 원인이 아니었던 것도 적어 둡니다. 페이지 캐시를 비워도 그대로였고, 사이트 주소의 http 를 https 로 고쳐도 그대로였고(이것은 canonical 이 http 로 나가는 별도 문제라 고치는 것이 맞습니다), 플러그인을 다시 켜도 그대로였습니다.

사이트맵이 열리는데 검색엔진이 안 읽는 경우는 서치콘솔 사이트맵이 안 읽힐 때에 적었습니다.

확인한 환경

항목	내용
프로그램	워드프레스, Rank Math SEO, wp-cli
확인한 날짜	2026년 7월 2일(규칙 미등록), 7월 23일(메타 태그), 7월 31일(관리형 호스팅), 10월 5일(사이트맵 캐시)

이어지는 이야기: robots.txt에 사이트맵 줄이 안 보일 때

이 글의 내용은 2026년 10월 5일에 마지막으로 확인했습니다. 틀린 곳을 발견하시면 연락처로 알려 주세요.