워드프레스에서 KBoard 플러그인은 정말 강력한 게시판 솔루션입니다. 하지만 많은 사용자들이 한번쯤 '링크가 제대로 작동하지 않는' 미스터리한 문제에 부딪히게 됩니다. 사이드바 최신글을 클릭했더니 빈 페이지가 나오거나, 주소창의 URL만 바뀌고 화면은 그대로 멈춰있는 현상. 더 나아가 구글 서치 콘솔에 제출한 사이트맵이 '거부'되는 총체적 난국까지.

저 역시 이 모든 문제를 겪으며 며칠 밤낮을 헤맸습니다. 그리고 마침내, 흩어져 있던 모든 문제의 조각들이 **'URL 생성 규칙의 충돌'**이라는 하나의 거대한 원인으로 귀결된다는 것을 알게 되었습니다.

이 글은 저와 같은 고통을 겪고 있는 분들을 위한 최종 가이드입니다. 이 글을 차근차근 따라오시면, 여러분의 KBoard와 관련된 모든 링크 문제를 해결할 수 있을 겁니다.

증상: 당신이 겪고 있는 문제는 무엇인가요?

• 증상 1 (위젯 링크 오류): 사이드바나 푸터에 KBoard 최신글 위젯/숏코드를 넣었는데, 글 제목을 클릭하면 홈페이지로 이동하거나, /?uid=123&mod=document 처럼 게시판 경로가 빠진 이상한 주소로 이동하며 페이지가 열리지 않는다.
• 증상 2 (AJAX 테마 충돌): 최신글 링크를 클릭하면 페이지가 새로고침 되지 않고, 브라우저 주소창의 주소만 바뀐 채 화면은 그대로 멈춰있다.
• 증상 3 (사이트맵 오류): SEO 플러그인이 생성한 kboard-sitemap.xml 파일의 링크들이 모두 리디렉션 경로로 잘못 생성되어 있거나, 구글 서치 콘솔에서 사이트맵 제출이 '거부'된다.

이 모든 문제는 겉보기엔 달라 보이지만, 뿌리는 같습니다.

근본 원인: 보이지 않는 URL 규칙의 전쟁

워드프레스는 '고유주소' 설정을 기반으로 모든 페이지의 주소를 만듭니다. KBoard, SEO 플러그인, 심지어 테마까지, 모두 이 기본 규칙 위에서 자신만의 URL 규칙을 추가하여 작동합니다.

문제는, 이 여러 규칙들이 서로 충돌하면서 발생합니다. 특히 KBoard가 자체적으로 가진 'RSS 피드' 기능이나 다른 SEO 플러그인과의 상호작용이 워드프레스의 URL 생성 시스템에 혼란을 주어, KBoard가 만들어야 할 정확한 게시글 주소(.../게시판경로/?uid=...)를 만들지 못하고 경로가 빠진 엉뚱한 주소를 만들게 되는 것입니다.

해결책: 단계별 완벽 처방전

이제 원인을 알았으니, 하나씩 문제를 해결해 보겠습니다. 1단계부터 순서대로 진행하는 것이 중요합니다.

1단계: 워드프레스 URL 규칙 강제 초기화 (가장 먼저!)

가장 기본적이면서 가장 강력한 해결책입니다. 꼬여버린 URL 생성 규칙을 깨끗하게 재설정합니다.

1. **관리자 > 설정 > 고유주소**로 이동합니다.
2. 아무것도 변경하지 말고 '변경사항 저장' 버튼을 누릅니다.
3. 페이지가 새로고침되면, 다시 한번 '변경사항 저장' 버튼을 한 번 더 누릅니다.
4. 이것만으로도 많은 사이트맵 및 링크 문제가 해결될 수 있습니다.
5. 2단계: [숏코드 사용 시] URL 속성 정확하게 입력하기

사이드바나 푸터에 KBoard 알림 :: id=null, 아이디값은 필수입니다. 숏코드를 사용하고 있다면, url 속성을 빠뜨렸을 가능성이 99%입니다.

• 잘못된 예: KBoard 알림 :: url=null, 페이지 주소는 필수입니다.
• 올바른 예: 

  제목	작성일
  [사례 공유] 인슐린 주사 권고를 극복한 '당뇨 식단 & 계피차' 관리 비법	2025.12.25
  유전적 취약성 심혈관 질환과 조기 심근경색증: 고위험 가족 사례에 대한 심층 유전 역학 및 정밀 의학 분석 보고서	2025.11.26
  인슐린과 암의 상관관계 상세 설명	2025.10.12
  [최종장 4부] 관계: 가장 강력한 치유의 힘	2025.10.07
  [최종장 3부] 운동: 최고의 항염증 명약	2025.10.07

이 url 속성은 KBoard에게 "링크를 만들 때 이 경로를 반드시 앞에 붙여줘!"라고 알려주는 매우 중요한 명령입니다.

3단계: KBoard RSS 기능 충돌 해결하기 (가장 강력한 해결책)

만약 1, 2단계를 거쳐도 문제가 해결되지 않는다면, KBoard의 RSS 기능이 다른 기능과 충돌하고 있을 가능성이 매우 높습니다. 이 기능만 비활성화하면 마법처럼 문제가 해결됩니다.

1. **관리자 > 외모 > 테마 파일 편집기**로 이동합니다.
2. 오른쪽 파일 목록에서 **테마 함수 (functions.php)**를 선택합니다.
3. 편집창 가장 아래쪽에 아래 코드를 그대로 복사해서 붙여넣습니다.
4. 
   

   
   

   
   

   remove_action('wp_head', 'kboard_head', 9);

   
   

   
   
   
   
5. **'파일 업데이트'**를 눌러 저장합니다.
6. 이 코드는 문제를 일으키는 KBoard의 RSS 피드 링크 생성 기능만 깔끔하게 비활성화합니다.

4단계: [AJAX 테마 전용] 강제 페이지 이동 스크립트 추가하기

링크를 클릭해도 주소창만 바뀌고 화면이 멈춰있다면, 사용 중인 테마의 '부드러운 페이지 전환(AJAX)' 기능과 충돌하는 것입니다.

1. **관리자 > 외모 > 위젯**으로 이동하여 문제가 발생하는 사이드바를 엽니다.
2. '사용자 정의 HTML' 위젯을 추가하고 아래 코드를 붙여넣습니다. (아래 .sidebar-area는 사용하는 테마에 따라 클래스명이 다를 수 있습니다. 개발자 도구로 확인 필요)

<script type="text/javascript">
jQuery(document).ready(function($){

    $('.sidebar-area a').on('click', function(e){

        if( $(this).attr('href').indexOf('mod=document') !== -1 ){

            e.preventDefault();

            window.location.href = $(this).attr('href');

        }

    });

});

</script>

4. 저장 후 확인합니다.

최종 점검: 사이트맵 다시 제출하기

위의 모든 과정을 거쳤다면, 이제 사이트맵도 정상적으로 생성될 것입니다.

1. 사용 중인 SEO 플러그인 설정에서 사이트맵 주소를 확인합니다.
2. 해당 주소가 웹 브라우저에서 XML 형식으로 깨끗하게 보이는지 확인합니다.
3. 구글 서치 콘솔에 가서 기존의 실패한 사이트맵은 삭제하고, 새로운 대표 사이트맵 주소(sitemap_index.xml 또는 sitemap.xml) 하나만 다시 제출합니다.

결론: 원인을 알면 두렵지 않습니다.

KBoard의 링크 및 사이트맵 오류는 매우 복합적인 원인으로 발생하기 때문에 해결이 어려운 것처럼 보입니다. 하지만 핵심은 **'URL 생성 규칙의 충돌'**이라는 점만 기억하시면 됩니다. 위의 단계들을 차근차근 점검하시면, 더 이상 어두운 굴속을 헤매지 않고 문제를 해결하실 수 있을 겁니다.

#해시태그 모음

#KBoard #케이보드 #워드프레스 #워드프레스오류 #사이트맵 #리디렉션 #SEO #검색엔진최적화 #워드프레스팁 #워드프레스꿀팁 #홈페이지제작 #블로그팁 #KBoard오류