플러그인을 업데이트한 직후 화면이 하얗게 변하거나 관리자 페이지까지 열리지 않는다면 플러그인 충돌을 먼저 확인해볼 필요가 있습니다. 특히 워드프레스에서 ‘사이트에 치명적인 오류가 발생했습니다’라는 메시지가 나타나는 경우에는 최근 설치하거나 업데이트한 플러그인과 테마의 호환성, PHP 환경 등을 순서대로 점검해야 합니다.
관리자 페이지(wp-admin)까지 접속할 수 없는 상황에서는 워드프레스 화면에서 문제를 해결하기 어렵습니다. 이때는 FTP 또는 호스팅 파일 관리자를 이용해 플러그인을 비활성화하고, 충돌을 일으킨 원인을 하나씩 확인하는 방법을 사용할 수 있습니다.
이 글에서는 관리자 페이지에 접속할 수 없는 상황을 기준으로 플러그인 충돌 여부를 확인하고 사이트를 정상적으로 복구하는 과정을 5단계로 정리합니다.
1. 워드프레스 플러그인 충돌이 발생하는 핵심 원인
플러그인은 사이트에 다양한 기능을 더해주지만, 호환성 검증 없이 설치할 경우 사이트 전체를 마비시키는 주범이 됩니다.
- 기능이 중복되는 플러그인 동시 사용: 특히 2개 이상의 캐시(Cache) 플러그인이나 보안(Security) 플러그인을 활성화할 경우 서버 스크립트 충돌이 자주 발생합니다.
- 업데이트가 중단된 플러그인 방치: 워드프레스 코어 엔진은 최신 버전인데 설치된 플러그인이 수년 간 업데이트되지 않은 경우 호환성 결함이 발생합니다.
- 테마 빌더와의 코드 간섭: 특정 테마의 페이지 빌더(Elementor 등)와 플러그인의 자바스크립트/CSS 스크립트가 서로 꼬이는 경우입니다.
- PHP 메모리 부족 (Memory Limit): 플러그인이 요구하는 PHP 메모리 할당량이 서버 설정값보다 높을 때 치명적 오류가 발생합니다.
2. 관리자 화면(wp-admin) 접속이 가능한 경우
화면 일부가 깨지거나 특정 메뉴 진입 시 오류가 발생하지만 관리자 패널 배후 접속이 가능하다면 가장 신속하게 조치할 수 있습니다.
- 관리자 메뉴에서 [플러그인] → [설치된 플러그인]으로 이동합니다.
- 최근에 설치했거나 업데이트를 진행했던 플러그인을 우선적으로 ‘비활성화’합니다.
- 브라우저를 새로고침(
F5)하여 사이트가 정상 작동하는지 확인합니다. - 정상으로 돌아왔다면 해당 플러그인이 범인이므로 삭제 후 대체 플러그인을 탐색합니다.
3. 관리자 화면 접속 불가 시 (FTP 강제 비활성화)
로그인조차 불가능한 완전 먹통 상태라면 워드프레스 내부가 아닌 외부 서버 제어판을 통해 플러그인을 강제 정지시켜야 합니다.
- FTP 프로그램 접속: 파일질라(FileZilla) 프로그램이나 호스팅사(클라우드웨이즈, 카페24 등)의 웹 파일 관리자에 접속합니다.
- 플러그인 경로 이동:
/wp-content/plugins폴더 경로로 이동합니다. - 폴더명 임시 변경:
plugins폴더의 이름을plugins_backup으로 변경합니다. - 결과 확인: 폴더명이 변경되면 워드프레스 코어가 플러그인 경로를 찾지 못해 모든 플러그인이 일괄 강제 비활성화됩니다. 이제 사이트 및 관리자 페이지에 다시 접속해 봅니다. 정상 열린다면 100% 플러그인 충돌 문제입니다.
4. 충돌을 일으킨 ‘진짜 범인’ 플러그인 색출법
사이트가 다시 열렸다면 전체 플러그인 중 어떤 제품이 시스템을 마비시켰는지 하나씩 찾아내는 과정이 필요합니다.
- FTP에서 아까 변경했던 폴더명
plugins_backup을 다시 원래의plugins로 되돌립니다. - 워드프레스 관리자 페이지 [플러그인] 메뉴로 들어가면, 모든 플러그인이 ‘비활성화’ 상태로 안전하게 보존되어 있습니다.
- 플러그인을 하나씩 차례대로 [활성화]를 누른 후 사이트 메인 페이지를 새로고침합니다.
- 특정 플러그인을 활성화하는 순간 사이트가 다시 뻗는다면, 해당 플러그인이 바로 충돌의 원인입니다. FTP로 들어가 해당 플러그인의 단독 폴더만 삭제하거나 이름을 변경해 주면 됩니다.
💡 추가 팁: PHP 메모리 리밋 확장 및 디버깅 모드
플러그인을 모두 비활성화했음에도 오류가 지속된다면 PHP 메모리 용량 부족일 가능성이 높습니다.
- wp-config.php 메모리 증설: FTP의 워드프레스 루트 경로에 위치한
wp-config.php파일을 열고 아래 코드를 추가하여 메모리 한도를 늘려줍니다.PHPdefine('WP_MEMORY_LIMIT', '256M'); - 디버그 모드 활성화 (오류 로그 확인): 정확한 오류 원인 구문을 확인하고 싶다면
wp-config.php내의 디버그 구문을true로 변경합니다.PHPdefine('WP_DEBUG', true); define('WP_DEBUG_LOG', true);
플러그인 오류 증상별 복구 절차 요약
| 장애 상태 | 주 원인 | 복구 조치 방법 |
|---|---|---|
| 관리자 페이지 접속 가능 | 특정 최근 플러그인 단독 오류 | 관리자 메뉴에서 해당 플러그인 즉시 비활성화 |
| 백지 화면(WSOD) 및 접속 불가 | 코어-플러그인 간 스크립트 충돌 | FTP 진입 후 /wp-content/plugins 폴더명 변경 |
| 특정 플러그인 활성화 시 뻗음 | 다른 플러그인 및 테마와 상충 | 대체 플러그인 설치 또는 삭제 처리 |
| “Fatal Error: Allowed memory…” | PHP 메모리 할당량 초과 | wp-config.php 내 WP_MEMORY_LIMIT 256M 상향 |
마치며: 안전한 사이트 운영을 위한 예방 수칙
워드프레스 플러그인 충돌은 사이트를 운영하면서 누구나 겪게 되는 자연스러운 과정입니다.
문제를 예방하기 위해서는 1) 보안/캐시 관련 중복 플러그인 설치 자제, 2) 업데이트 전 UpdraftPlus 등을 활용한 백업 데이터 생성, 3) 최소한의 필수 플러그인만 유지하는 미니멀리즘을 실천하는 것이 사이트 속도 향상과 시스템 안정성에 가장 좋습니다.
치명적 오류가 발생하더라도 당황하지 마시고, 안내해 드린 FTP 폴더 제어 방식을 통해 차근차근 복구해 보시기 바랍니다!