[워드프레스] Sitemap.xml 에러 해결방법 ( error on line 3 at column 6: XML declaration allowed only at the start of the document )

Sitemap.xml 에러 해결방법

워드프레스 사이트 생성 후 테마 설정을 다 끝내고 사이트맵을 열었더니 아래와 같은 에러 메세지가 노출되고 있다.

 

 

처음에는 당황에서 어디서부터 잘못된 것인가 멘붕이 왔었는데, 좀 검색해보니 생각보다 빈번하게 발생하는 문제이며, 의외로 간단(?)하게 해결 할 수 있었다.

 

일반적으로 Yoast 플러그인 적용 중에 새로운 테마를 적용했을 때 발생하는 문제로, 테마 소스 일부에 빈 공백이 잘못 추가되었을 때 생기는 문제.

 

오류에 대한 자세한 내용은 아래 링크에서 확인이 가능

 

Sitemap Error: XML or text declaration not at start of entity - Yoast Knowledge Base

Explains the cause of and the solution to the: Sitemap Error: XML or text declaration not at start of entity notification.

kb.yoast.com

 

해결하는 방법

워드프레스 관리자에서 외모 - 테마 편집기로 들어가 테마 편집화면으로 이동한다.

 

 

편집기의 테마 파일들을 살펴보면 파일의 확장자가 php로 끝나는 파일들을 확인할 수 있다.

이제 이 파일들을 하나하낳 확인하여 의미없이 들어간 공백 또는 라인을 차례대로 삭제해준다.

 

 

* 설정한 테마에 따라 파일 목록은 차이가 날 수 있음.

 

 

 

그럼 어떤 공백, 어떤 라인을 삭제해야하느냐. <?php 로 시작하는 코드 이전에 들어가있는 공백과 라인을 말한다.

 

 

 

- <?php 코드 위에 들어가 있는 공백라인 삭제
- <?php 코드 앞에 들어가있는 공백 제거

 

 

- <?php 코드들 위에 들어가 있는 공백라인들 모두 삭제

 

 

공백 제거 작업 중 실수로 코드를 잘못 건드리지 않도록 주의해야한다.

꼭 공백이나 라인만. 띄어쓰기를 지우는 일이 없도록 주의하자.

 

 

테마 내 php 파일 모두를 수정하지 않아도 문제가 되는 공백이 제거되면 사이트맵이 정상적으로 보이므로, 제거 작업 중간중간 저장하여 사이트맵이 정상으로 돌아왔는지 확인을 해 볼 필요가 있다.

 

몇개 삭제 안했는데 사이트맵이 돌아온다면 불필요한 제거작업을 줄일 수 있으므로...

 

 

문제가 되는 공백이 제거되면 에러메세지가 사라지고 정상적으로 사이트 맵이 노출된다.