잘 나오던 글이 왜 갑자기 먹통? 워드프레스 숏코드 충돌 깔끔하게 잡는 법

오랫동안 문제없이 잘 노출되던 효자 포스팅 하나가 갑자기 어떻게 변해있나 확인하려고 방문했다가 가슴이 철렁 내려앉는 경험을 했습니다.

평소에 깔끔하게 보이던 본문 내용이 싹 지워진 것처럼 휑하게 비어있거나, 글 중간중간에 나 알 수 없는 대괄호 묶음의 숏코드 문자들만 덩그러니 남아있는 것이었습니다.

분명 데이터베이스에는 글 내용이 고스란히 저장되어 있는데, 특정 플러그인이나 테마를 업데이트한 직후부터 숏코드 기능이 꼬이면서 본문 전체가 레이아웃 와장창 깨진 채 먹통이 되어버린 것이죠.

방문자들은 이 깨진 페이지를 보고 발길을 돌릴 텐데 구글 애드센스 승인 심사 기간에 이런 에러까지 겹쳤다고 생각하니 식은땀이 줄줄 흘렀습니다. 저처럼 어느 날 갑자기 숏코드 충돌로 본문이 통째로 날아간 것처럼 보여 당황하셨을 분들을 위해, 제가 직접 찾아내고 해결했던 뼈아픈 대처 과정을 풀어봅니다.

숏코드 충돌은 왜 갑자기 터지는 걸까

워드프레스에서 숏코드는 복잡한 기능을 대괄호 하나로 불러다 쓰는 아주 편리한 도구입니다. 하지만 이 기능이 어느 날 갑자기 에러를 일으키는 주된 이유는 다음과 같습니다.

• 플러그인 비활성화 또는 삭제: 숏코드를 제공하던 전용 플러그인(예: 표 생성기, 갤러리 플러그인 등)을 업데이트하다가 오류가 나거나 실수로 비활성화하면, 워드프레스는 그 코드를 어떻게 해석해야 할지 몰라 본문 전체를 뱉어내거나 빈 페이지로 만들어버립니다.
  
• 테마 변경 및 함수 충돌: 사용 중인 테마를 다른 것으로 교체하거나 테마 내부의 숏코드 처리 함수에 문제가 생기면, 기존에 글마다 박혀 있던 대괄호 코드들이 일제히 기능을 상실하고 충돌을 일으키게 됩니다.

원인을 파악했으니 이제 멘탈을 가다듬고 차근차근 화면을 복구할 차례입니다.

본문을 살리기 위해 가장 먼저 확인해야 할 점

서버 파일을 건드리거나 코드를 수정하기 전에, 내 블로그의 어떤 부분이 문제의 원인인지 좁혀보는 안전한 진단 과정이 필요합니다.

• 최근에 건드린 플러그인 체크하기: 숏코드가 깨지기 직전에 새로 설치했거나 업데이트 버튼을 누른 플러그인이 있다면 범인일 확률이 99프로입니다. 해당 플러그인을 잠시 비활성화해 보고 글 화면이 원래대로 돌아오는지 테스트해 봅니다.
  
• 에디터 화면에서 코드 흔적 찾기: 글 수정 모드로 들어가서 본문 영역에 문법이 틀린 대괄호([...])가 닫히지 않고 남아있거나 특수문자와 꼬여있는 곳이 없는지 눈으로 꼼꼼하게 스캔해 봅니다.

숏코드 충돌을 근본적으로 잠재우는 실전 해결책

임시방편이 아니라 앞으로도 이런 충돌로 글이 먹통이 되는 일을 막으려면 확실하게 대처를 해주어야 합니다.

• 문제의 플러그인 교체 또는 재설치: 충돌을 일으키는 원인 플러그인을 완전히 삭제한 뒤 최신 버전으로 재설치하거나, 지원이 끊긴 플러그인이라면 안정적인 다른 대체 플러그인으로 갈아타는 것이 가장 깔끔합니다.
  
• 사용하지 않는 숏코드 일괄 정리하기: 이미 탈퇴했거나 지운 플러그인의 숏코드 찌꺼기가 글 전반에 남아있는 경우라면, functions.php 파일에 add_shortcode('문제의숏코드이름', '__return_empty_string'); 형태의 코드를 넣어 빈 공백으로 처리해 주거나 텍스트 일괄 치환 플러그인을 통해 지저분한 괄호 코드를 말끔하게 도려내야 합니다.

직접 겪고 깨달은 숏코드 에러 대처 팁

• 기능성 플러그인은 가급적 신중하게 쓰기: 글 본문마다 특정 디자인이나 박스를 넣겠다고 온갖 플러그인의 숏코드를 남발하면 나중에 테마를 바꾸거나 플러그인을 정리할 때 지옥을 맛보게 됩니다. 가급적 기본 구텐베르크 블록 위주로 글을 쓰는 습관이 정신 건강에 이롭습니다.
  
• 수정 전 백업은 선택이 아닌 필수: 오류를 잡는다고 관리자 페이지에서 코드를 수정하거나 플러그인을 지웠다 깔았다 할 때는 반드시 데이터베이스나 해당 글 내용을 사전에 다른 곳에 복사해 두는 여유를 가져야 합니다.

잘 나오던 본문이 갑자기 휑하게 비어버리거나 대괄호 코드만 난무할 때는 정말 머릿속이 하얗게 변합니다.

하지만 대부분 최근에 바뀐 플러그인 충돌 때문이니, 너무 놀라지 마시고 최근에 업데이트한 기능부터 차근차근 점검해 보시길 바랍니다!