WordPress 플러그인 충돌 디버깅 — 원인 찾기·해결·예방

플러그인 충돌은 WordPress 운영 중 가장 흔한 문제입니다. 한 플러그인 활성화 후 갑자기 사이트가 깨지거나·일부 기능이 멈추거나·관리자 접속 불가. 다행히 순차 진단으로 30분 안에 원인 발견 가능.

충돌의 5가지 신호

1. 흰 화면 (사이트 또는 관리자)
2. PHP 오류 메시지 표시
3. 특정 기능 미작동 (폼·검색·메뉴 등)
4. 디자인 깨짐
5. 속도 급격히 느려짐

위 증상 발생 시점 = 보통 마지막 작업(플러그인 활성화·업데이트·테마 변경) 직후.

진단 5단계

1. 백업 확인

작업 전 자동 백업 있는지 확인. 없으면 즉시 백업.

2. 마지막 작업 기억

• 어떤 플러그인을 새로 설치했나?
• 어떤 플러그인을 업데이트했나?
• 테마를 바꿨나?

가장 의심.

3. 의심 플러그인 비활성

플러그인 > 설치된 플러그인 > 의심 플러그인 비활성화 → 사이트 점검.

• 정상 복귀 → 그 플러그인이 원인
• 그대로 → 다음 단계

4. 모든 플러그인 일괄 비활성

설치된 플러그인 > 모두 체크 → 일괄 작업: 비활성화.

• 정상 복귀 → 플러그인 중 하나가 원인 (1개씩 활성화하며 찾기)
• 그대로 → 테마 또는 코어 문제

5. 기본 테마로 전환

외모 > 테마 > Twenty Twenty-Five 활성화.

• 정상 → 테마 문제
• 그대로 → WordPress 코어·DB·서버 문제

Health Check & Troubleshooting 플러그인

운영 사이트를 깨지 않고 진단:

플러그인 Health Check & Troubleshooting 설치 후:

1. 도구 > Site Health > Troubleshooting
2. Enable Troubleshooting Mode 클릭
3. 본인만 보이는 트러블슈팅 모드 (방문자는 정상 사이트 그대로)
4. 플러그인·테마를 자유롭게 끄고 켜며 진단
5. 끝나면 트러블슈팅 모드 종료

운영 사이트에 가장 안전한 진단 도구. 강력 추천.

관리자 접속 불가 시

WordPress 관리자도 안 열려 플러그인 비활성화 못 할 때:

방법 1: FTP로 폴더 이름 변경

1. FTP·호스팅 파일 매니저로 wp-content/plugins/ 진입
2. 플러그인 폴더 전체를 plugins-disabled 같은 이름으로 변경
3. WordPress가 모든 플러그인을 못 찾아 비활성화 처리
4. 관리자 접속 가능해지면 다시 plugins로 복원
5. 1개씩 활성화하며 원인 찾기

방법 2: 특정 플러그인만

의심 플러그인 폴더만 이름 변경: wp-content/plugins/elementor → elementor-disabled

해당 플러그인만 비활성. 다른 플러그인은 정상.

방법 3: WP-CLI (서버 SSH 가능 시)

wp plugin deactivate --all

또는 특정 플러그인만:

wp plugin deactivate elementor

PHP 오류 메시지 해석

흔한 오류:

Fatal error: Class ‘X’ not found

원인: 의존 플러그인 누락. 다른 플러그인이 필요한 클래스 미설치. 해결: 의존 플러그인 설치 또는 문제 플러그인 비활성.

Allowed memory size of X bytes exhausted

원인: PHP 메모리 부족. 해결: wp-config.php에 define('WP_MEMORY_LIMIT', '256M'); 추가.

Maximum execution time of X seconds exceeded

원인: PHP 실행 시간 부족. 해결: wp-config.php에 set_time_limit(300); 또는 호스팅 설정 변경.

Cannot modify header information

원인: 출력 후 헤더 변경 시도. PHP 파일의 <?php 앞에 공백 있는 경우 흔함. 해결: 자식 테마·플러그인 파일 점검.

디버그 모드

자세한 오류 로그:

wp-config.php에:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

오류가 wp-content/debug.log에 기록됨.

운영 사이트에선 WP_DEBUG_DISPLAY를 false로 (방문자에게 오류 안 보이게).

해결 후 WP_DEBUG를 false로 (성능·보안).

자주 충돌하는 조합

경험상 충돌 잦은:

원칙: 같은 카테고리 = 1개만.

플러그인 호환성 사전 점검

새 플러그인 설치 전:

1. 평점·리뷰

WordPress 공식 저장소에서 5점 만점. 3.5+ 권장.

2. 마지막 업데이트

3개월 이내 권장. 1년+ 미업데이트 = 위험.

3. WordPress 호환 버전

플러그인 페이지의 “Tested up to”. 본인 WordPress 버전과 일치.

4. 활성 설치 수

10,000+ 권장. 검증된 플러그인일 가능성 ↑.

5. 지원 포럼 활성

최근 문의·답변 활발한지.

충돌 예방 — 7가지 원칙

1. 백업 항상: 변경 전 백업
2. 하나씩 변경: 동시에 여러 변경 X
3. 스테이징에서 테스트: 운영 사이트에 바로 X
4. 카테고리당 1개: 같은 기능 플러그인 중복 X
5. 신뢰 출처만: nulled·외부 사이트 X
6. 정기 업데이트: 옛 버전끼리도 충돌 가능
7. 사용 안 하면 삭제: 비활성으론 부족

충돌 해결 후 — 사후 점검

• 사이트 정상 작동 확인
• Search Console 색인 정상 (가능하면 며칠 후)
• Analytics 트래픽 정상
• 검색 노출 변동 모니터링

⚠️ 자주 하는 실수

• 백업 없이 진단: 더 망가질 수 있음
• 여러 변경 동시: 원인 찾기 불가
• 운영 사이트에서 무작정 비활성화: 방문자 영향
• 트러블슈팅 모드 안 씀: 위험·번거로움
• 충돌 후 그냥 원래대로: 재발 가능

❓ FAQ

Q. 특정 플러그인 비활성화하니 해결됐는데, 그 기능 꼭 필요해요. A. 대안 플러그인 사용 또는 해당 플러그인 개발자에게 문의. 충돌 패치 받기.

Q. 플러그인 업데이트 후 사이트 깨지면? A. 업데이트 직후라면 해당 플러그인의 옛 버전 설치 (롤백 플러그인). 또는 백업 복구.

Q. 가장 안전한 플러그인 설치 절차? A. 1) 백업 → 2) 스테이징에서 테스트 → 3) 본 사이트에 설치 → 4) 즉시 점검.

Q. 호스팅사가 도와주나요? A. 호스팅 서버·코어 문제만. 플러그인 충돌은 본인 책임. 다만 일부 호스팅은 무료 진단 지원.

Q. 충돌 자주 발생하면 호스팅·테마 바꿔야? A. 우선 충돌 패턴 분석. 같은 카테고리 플러그인 중복이 원인이면 호스팅·테마 무관. 메모리·서버 사양 문제면 호스팅 검토.

관련 가이드

• 필수 플러그인 10선
• 흰화면·관리자 접속 불가
• 테마 충돌 해결
• 백업 시작하기