소개
WordPress 플러그인에 문제가 생기면 정확한 원인을 찾기 어려운 경우가 많습니다. 문제는 플러그인 충돌, 테마 비호환성, 서버 구성 문제 등에서 비롯될 수 있습니다. WordPress.org 팀이 개발한 “Health Check & Troubleshooting” 플러그인은 이러한 문제를 분리하고 파악하는 데 도움이 되는 강력한 진단 도구입니다.
Health Check & Troubleshooting이란?
Health Check & Troubleshooting은 다음과 같은 작업을 할 수 있는 WordPress.org 공식 플러그인입니다:
- WordPress 설치 환경 진단 실행
- 본인의 사용자 세션에서만 모든 플러그인을 비활성화하고 기본 테마로 전환하는 “문제 해결 모드” 시작
- 플러그인과 테마를 선택적으로 다시 활성화하여 충돌 파악
- 지원 요청에 필요한 사이트 기술 정보 수집
가장 큰 장점은 문제 해결 모드가 관리자 본인에게만 적용된다는 점입니다 – 문제를 진단하는 동안에도 방문자에게는 사이트가 평소처럼 표시됩니다.
설치
- WordPress 대시보드에 로그인하세요
- 플러그인 > 새로 추가로 이동하세요
- “Health Check & Troubleshooting”을 검색하세요
- “지금 설치”를 클릭한 다음 “활성화”를 클릭하세요
브라우저 콘솔에서 JavaScript 오류 확인하기
Health Check 플러그인을 사용하기 전에, 기능 문제의 원인이 될 수 있는 JavaScript 오류를 먼저 확인해 보면 도움이 되는 경우가 많습니다:
- 브라우저의 개발자 도구를 여세요:
- Chrome/Edge: F12 키를 누르거나 마우스 오른쪽 버튼을 클릭하고 “검사”를 선택하세요
- Firefox: F12 키를 누르거나 마우스 오른쪽 버튼을 클릭하고 “요소 검사”를 선택하세요
- Safari: 환경설정 > 고급에서 개발자 도구를 활성화한 다음 Option+Command+I를 누르세요
- “콘솔” 탭으로 이동하세요
- 문제가 있는 기능을 직접 사용해 보세요(버튼 클릭, 양식 제출 등)
- 콘솔에 나타나는 빨간색 오류 메시지를 찾으세요
- 오류에 언급된 스크립트 이름을 확인하세요
- 파일 경로에 특정 플러그인이 언급되어 있다면 기록해 두세요
- “undefined” 또는 “null” 오류와 같은 패턴을 찾으세요
- 발견한 오류를 기록하여 지원팀과 공유하세요
JavaScript 오류를 보면 어떤 플러그인이 문제를 일으키는지 바로 알 수 있거나, 충돌의 성격에 대한 중요한 단서를 얻을 수 있는 경우가 많습니다.
문제 해결 모드로 문제 진단하기
1단계: 문제 해결 모드 시작#
- 도구 > 사이트 상태로 이동하세요
- “문제 해결” 탭을 클릭하세요
- “문제 해결 모드 시작” 버튼을 클릭하세요
- WordPress가 모든 플러그인이 비활성화되고 기본 테마를 사용하는 기본 상태로 다시 로드됩니다(본인의 세션에서만)
2단계: 문제 테스트#
문제 해결 모드에서 기존에 겪던 문제가 여전히 발생하는지 테스트하세요:
- 문제가 해결된 경우(더 이상 발생하지 않음): 플러그인 또는 테마와 관련된 문제임이 확인된 것입니다
- 문제가 계속되는 경우: WordPress 코어 파일, 서버 구성 또는 데이터베이스와 관련된 문제일 수 있습니다
3단계: 체계적인 테스트(문제가 해결된 경우)#
문제 해결 모드에서 문제가 해결되었다면 다음 단계에 따라 구체적인 원인을 찾으세요:
- 문제 해결 모드인 상태에서 테마 옆의 “플러그인 활성화 및 테스트”를 클릭하여 테마가 문제의 원인인지 테스트하세요
- 문제가 다시 나타나면 테마가 원인입니다
- 문제가 다시 나타나지 않으면 플러그인 테스트를 계속하세요
- 플러그인을 하나씩 활성화하세요:
- 플러그인 옆의 “플러그인 활성화 및 테스트”를 클릭하세요
- 플러그인을 하나 활성화할 때마다 문제가 다시 나타나는지 테스트하세요
- 문제를 다시 일으키는 플러그인을 찾을 때까지 계속하세요
- 충돌하는 플러그인이나 테마를 찾았다면:
- 기록해 두세요
- 비활성화한 상태로 두거나 개발자에게 지원을 요청할 수 있습니다
4단계: 문제 해결 모드 종료#
문제를 파악했다면:
- 화면 상단의 “문제 해결 모드 비활성화”를 클릭하세요
- 모든 플러그인과 테마가 활성화된 정상 상태로 사이트가 돌아갑니다
충돌을 파악한 후 해야 할 일
플러그인에 문제가 있는 경우:#
- 플러그인에 사용 가능한 업데이트가 있는지 확인하세요
- 플러그인 지원 포럼에서 비슷한 문제를 검색하세요
- 다음과 같은 구체적인 정보를 포함하여 플러그인 개발자에게 문의하세요:
- WordPress 버전
- PHP 버전
- 활성화된 기타 플러그인
- 문제 재현 단계
- 브라우저 콘솔의 오류 메시지
테마에 문제가 있는 경우:#
- 테마 업데이트가 있는지 확인하세요
- 일시적으로 기본 WordPress 테마로 전환하는 것을 고려하세요
- 구체적인 정보를 포함하여 테마 개발자에게 문의하세요
문제 해결 모드에서도 문제가 계속되는 경우:#
다음과 같은 더 근본적인 문제가 있을 수 있습니다:
- WordPress 코어 파일 무결성 문제
- 데이터베이스 손상
- 서버 구성 문제
- PHP 버전 호환성 문제
이런 경우 다음을 고려하세요:
- 사이트 상태 검사 실행(도구 > 사이트 상태 > 상태)
- 호스팅 업체와 상담하기
- WordPress 개발자에게 도움 요청하기
고급 문제 해결 기법
Health Check 디버깅 정보 활용하기#
- 도구 > 사이트 상태 > 정보로 이동하세요
- 이 페이지에는 WordPress 구성에 대한 자세한 정보가 표시됩니다
- “사이트 정보를 클립보드로 복사”를 클릭하여 지원팀과 공유하세요
다른 사용자 계정으로 테스트하기#
특정 사용자 역할에서만 문제가 발생하는 경우도 있습니다:
- 다른 역할을 가진 임시 사용자 계정을 만드세요
- 새 사용자 계정에서도 문제가 발생하는지 테스트하세요
서버 오류 로그 확인하기#
서버 오류는 브라우저에 표시되지 않을 수 있습니다:
- 호스팅 제어판에서 오류 로그를 확인하세요
- 또는 wp-config.php 파일에
define('WP_DEBUG', true);및define('WP_DEBUG_LOG', true);코드를 추가하세요 - 오류는 /wp-content/debug.log에 기록됩니다
효율적인 문제 해결을 위한 팁
- 이진 탐색 방법: 플러그인이 많은 사이트에서는 “분할 정복” 방식을 사용하세요:
- 플러그인의 절반을 활성화하고 테스트하세요
- 문제가 나타나면 그 절반에 원인이 있고, 그렇지 않으면 나머지 절반에 있습니다
- 원인을 찾을 때까지 문제가 있는 그룹을 계속 절반으로 나누세요
- 플러그인이 많을 때는 하나씩 테스트하는 것보다 이 방법이 훨씬 빠릅니다
- 복합적인 충돌: 일부 문제는 여러 플러그인의 조합으로 인해 발생한다는 점에 유의하세요:
- 문제가 되는 플러그인을 하나로 특정할 수 없다면 여러 조합으로 테스트해 보세요
- 비슷한 기능을 하는 플러그인(여러 SEO 플러그인, 여러 캐싱 솔루션 등)에 주의하세요
- 두 플러그인이 각각은 잘 작동하지만 함께 사용하면 충돌하는 경우도 있습니다
- 체계적인 기록: 테스트한 내용과 결과를 자세히 기록해 두세요
- 최근 변경 사항: 최근에 설치하거나 업데이트한 플러그인 또는 테마부터 테스트하세요
- 흔한 원인: 영향이 큰 플러그인(캐싱, 보안, 최적화 플러그인)부터 테스트하세요
- 캐시 비우기: 테스트할 때는 반드시 캐싱 플러그인의 캐시를 비우세요
- 브라우저 테스트: 여러 브라우저에서 테스트하여 특정 브라우저에서만 발생하는 문제인지 확인하세요
플러그인 지원팀에 문의해야 하는 경우
문제를 파악했지만 직접 해결할 수 없다면:
- 종합적인 정보를 수집하세요:
- WordPress 버전
- PHP 버전
- 활성화된 플러그인 전체 목록
- 테마 이름 및 버전
- 브라우저 및 기기 정보
- 문제를 재현하는 정확한 단계
- 해당되는 경우 스크린샷 또는 화면 녹화
- 브라우저 콘솔의 오류 메시지
- 기존 문서를 확인하세요:
- 플러그인의 지식 베이스를 검토하세요
- 플러그인 지원 포럼에서 비슷한 문제를 검색하세요
- 상세한 지원 티켓을 제출하세요:
- 위에서 수집한 모든 정보를 포함하세요
- 이미 시도한 내용을 구체적으로 설명하세요
- Health Check를 사용하여 문제를 분리했다는 사실을 언급하세요
- 가능하고 적절하다면 임시 관리자 접근 권한을 제공하세요
처음 지원을 요청할 때 더 많은 정보를 제공할수록 지원팀이 더 빠르게 문제 해결을 도와드릴 수 있습니다.
마치며
Health Check & Troubleshooting 플러그인은 운영 중인 사이트에 영향을 주지 않고 WordPress 문제를 진단할 수 있는 매우 유용한 도구입니다. 플러그인과 테마를 체계적으로 테스트하면 충돌을 파악하고, 필요할 때 지원팀에 자세한 정보를 제공할 수 있습니다.
참고: 플러그인, 테마 또는 코어 파일을 크게 변경하기 전에는 항상 WordPress 사이트를 백업하세요.
참고 자료#
2026년 4월 16일 업데이트 · 도움이 필요하신가요? 지원 티켓을 등록하세요