워드프레스 블로그 세팅을 위해 모양 » 위젯을 클릭할 때 '... 블록은 오류의 영향으로 제대로 작동하지 않을 수 있습니다' 경고가 표시되는 문제를 최근 경험했습니다. 이 오류는 워드프레스 5.8 업데이트 이후 도입된 블록 기반 위젯 편집기에서 흔히 발생하는 대표적인 스크립트 충돌 현상입니다.
그림처럼 특정 블록 하나가 아닌 모든 위젯 블록에서 동시에 오류가 표시된다면, 특정 플러그인이 블록 위젯 편집기에 필요한 자바스크립트와 충돌하거나 스크립트의 정상적인 로드를 방해하고 있을 가능성이 높습니다.
플러그인 충돌로 인한 워드프레스 블록 위젯 오류 해결하기
기존 위젯을 삭제하고 새 위젯을 추가하기 위해 위젯 페이지에 접속할 때 '"nav_menu" 블록은 오류의 영향으로 제대로 작동하지 않을 수 있습니다'와 같은 경고가 표시되는 경우가 있을 수 있습니다.
이 오류는 블록 기반 위젯 편집기(Block-based Widgets Editor)가 구동되는 과정에서 자바스크립트(JS) 렌더링에 실패할 때 발생합니다.
- 플러그인 및 테마 충돌: 기존 레거시 방식으로 제작된 위젯이나 특정 플러그인이 새로운 React 기반의 블록 편집기 스크립트와 충돌하여 이 에러가 발생할 수 있습니다.
- REST API 통신 방해: 블록 위젯 에디터는 백엔드와 REST API를 통해 데이터를 주고받습니다. Cloudflare WAF와 같은 방화벽의 엄격한 보안 규칙이나, 브라우저 확장 프로그램 등이 이 통신을 차단하면 화면을 제대로 불러오지 못하고 오류를 뿜어낼 수 있습니다.
이 문제가 발생할 경우 간단히는 클래식 위젯(Classic Widgets) 플러그인을 설치하면 보통 오류가 해결됩니다.
하지만 이 방법은 근본적인 해결책이라고 보기 어렵습니다. 클래식 위젯 플러그인은 블록 기반 위젯 편집기를 비활성화하고 기존 클래식 편집기로 되돌리는 방식으로 동작하기 때문에, 충돌을 일으키는 플러그인을 그대로 둔 채 문제를 우회하는 것에 불과합니다.
해당 플러그인이 위젯 편집기 외의 다른 영역에서도 스크립트 충돌을 일으킬 수 있고, 워드프레스가 블록 편집기 중심으로 계속 발전해 나가는 방향을 고려하면 고전 위젯에 대한 공식 지원이 언제까지 유지될지도 불분명하기 때문입니다.
문제의 원인은 오래된 플러그인
이 오류가 발생했다면 먼저 브라우저 개발자 도구의 콘솔 패널을 열어 어떤 에러 메시지가 출력되고 있는지 확인해보세요. 운이 좋으면 문제의 원인을 파악하는 데 단서가 될 만한 메시지를 발견할 수도 있습니다.
제 경우에는 문제의 원인은 Fixed TOC라는 유료 목차 플러그인이었습니다. 이 플러그인 때문에 오류 메시지가 표시될 뿐만 아니라 기존 위젯을 삭제해도 삭제가 되지 않은 현상도 발생했습니다.
이 블로그에도 Fixed TOC가 몇 년 사용되었지만, 이 플러그인은 블록 위젯과 호환되지 않아서 플러그인 개발자는 Fixed TOC를 업데이트하는 대신 Torcer라는 이름의 플러그인으로 새롭게 만들었습니다. Fixed TOC 사용자는 Codecanyon에서 Tocer를 다운로드할 수 있습니다.
Fixed TOC 플러그인이 설치되어 있다면 이 플러그인을 삭제하고, 대신 플러그인 개발자가 제공하는 Torcer를 설치하시기 바랍니다. (Fixed TOC 플러그인 구입자는 추가 비용 없이 Tocer를 다운로드할 수 있습니다.)
저는 Tocer를 잠시 사용하다가 지금은 위키피디아에서 사용되는 것과 비슷한 기능의 목차 플러그인을 자체적으로 만들어 적용하고 있습니다.
무료 목차 플러그인으로는 간편한 목차(Easy Table of Contents) 플러그인이 많은 인기를 끌고 있습니다.
간편한 목차(이전 명칭은 "쉬운 목차") 플러그인은 2026년 7월 현재 60만 개가 넘는 사이트에 설치되어 사용되고 있습니다.
목차 플러그인을 설치하면 사이트 속도에 약간의 영향을 미칠 수 있지만, SEO에 긍정적인 영향을 미치고 다양한 기능을 제공하여 원하는 디자인의 목차를 자동으로 표시할 수 있습니다. (티스토리나 블로그스팟에서는 스킨/테마를 편집하여 목차 관련 스트립트를 직접 추가해야 하는 번거로움이 있고, 기능을 자유롭게 커스텀하는 데 한계가 있습니다.)
마치며
블록 위젯은 2021년 7월에 공개된 워드프레스 5.8 버전에서 도입되었기 때문에 지금은 대부분의 플러그인이 블록 위젯과 호환이 되지만, 오래된 구형 플러그인은 문제를 일으킬 수 있습니다.
이 오류가 발생하면 사이트를 백업하고 워드프레스, 테마, 플러그인을 모두 최신 버전으로 업데이트하는 것도 고려할 수 있습니다. 최신 버전으로 업데이트하면 문제가 해결될 수도 있습니다.
하지만 플러그인 자체가 오래 전부터 업데이트가 중단되었다면 플러그인 충돌 문제가 보안 문제를 야기할 수 있으므로, 그런 플러그인은 가급적 삭제하는 것이 바람직합니다.
댓글 남기기