워드프레스 플러그인 충돌 해결: 사이트가 안 열릴 때 순서대로 할 일
워드프레스 플러그인 충돌로 사이트가 안 열리면 원인 플러그인을 비활성화하는 것이 가장 빠른 해결책입니다. 관리자 화면에 들어갈 수 있으면 플러그인을 하나씩 끄며 확인하고, 관리자 화면까지 막혔다면 워드프레스가 보내는 복구 모드 이메일을 쓰거나 서버에서 plugins 폴더 이름을 바꿔 전체를 한 번에 끄면 됩니다. 플러그인 오류는 새로 설치할 때뿐 아니라 업데이트할 때도 자주 생기므로, 업데이트 전 백업을 습관으로 만드는 것이 가장 좋은 예방법입니다.
목차
플러그인 충돌이 생기는 대표 상황
여러 사이트를 운영하면서 보면, 플러그인 문제는 “평소 잘 되던 사이트가 어떤 작업 직후 갑자기” 터지는 경우가 대부분입니다.
- 새 플러그인 설치 직후: 기존 플러그인과 같은 기능(캐시, 최적화, SEO 등)을 겹쳐 쓰면 충돌하기 쉽습니다.
- 플러그인 업데이트 직후: 새 버전이 테마나 다른 플러그인, 서버의 PHP 버전과 맞지 않을 때 생깁니다. 자동 업데이트가 켜져 있으면 모르는 사이에 사이트가 멈출 수 있습니다.
- 워드프레스 코어나 PHP 버전 업데이트 직후: 오래 관리되지 않은 플러그인이 새 환경에서 오류를 냅니다.
증상별로 원인 좁히기
| 증상 | 가능성이 큰 원인 | 먼저 할 일 |
|---|---|---|
| “이 웹사이트에 치명적인 오류가 발생했습니다” 문구 | 플러그인·테마의 PHP 오류 | 관리자 이메일의 복구 모드 링크 확인 |
| 흰 화면만 나옴 | PHP 오류가 화면에 표시되지 않는 상태 | 디버그 로그 켜서 오류 파일 확인 |
| 관리자 화면만 깨짐 | 관리 화면용 스크립트 충돌 | 최근 설치·업데이트한 플러그인부터 비활성화 |
| 디자인·레이아웃만 깨짐 | 캐시·최적화 플러그인의 CSS·JS 처리 | 캐시 비우고 최적화 옵션 끄기 |
| 로그인하면 다시 로그인 화면 | 보안·캐시 플러그인의 쿠키 처리 | 해당 플러그인 비활성화 후 재로그인 |
관리자 화면에 들어갈 수 있을 때
- 최근에 설치하거나 업데이트한 플러그인부터 비활성화하고 사이트를 확인합니다.
- 원인을 모르겠다면 모든 플러그인을 비활성화한 뒤 하나씩 다시 켜며 문제가 생기는 지점을 찾습니다.
- 방문자에게 영향을 주기 싫다면 워드프레스 공식 디렉터리의 Health Check & Troubleshooting 플러그인의 문제 해결 모드를 씁니다. 이 모드에서는 내 로그인 세션에서만 플러그인이 꺼진 상태로 보여 방문자 화면은 그대로 유지됩니다.
- 원인 플러그인을 찾았다면 이전 버전으로 되돌리거나, 개발자의 지원 게시판에 같은 문제가 올라왔는지 확인합니다.
관리자 화면도 안 열릴 때
- 복구 모드 이메일 확인: 워드프레스 5.2부터는 치명적인 오류가 생기면 관리자 이메일로 복구 모드 링크를 보냅니다. 이 링크로 들어가면 문제를 일으킨 플러그인이 일시 중지된 상태로 관리자 화면을 쓸 수 있습니다. 자세한 동작은 워드프레스 코어 팀의 복구 모드 안내에 나와 있습니다.
- plugins 폴더 이름 바꾸기: 이메일이 오지 않았다면 SFTP나 서버 파일 관리자로
wp-content/plugins폴더 이름을plugins_off처럼 바꿉니다. 그러면 모든 플러그인이 한 번에 비활성화됩니다. - 관리자 접속 후 원래 이름으로 복구: 사이트가 열리면 폴더 이름을 다시 plugins로 바꾸고, 관리자 화면에서 플러그인을 하나씩 활성화하며 원인을 찾습니다.
- 특정 플러그인만 끄기: 원인이 짐작된다면 plugins 폴더 안의 해당 플러그인 폴더 이름만 바꿔도 됩니다.

도커 기반 패널을 쓴다면 파일 위치가 일반 호스팅과 다를 수 있습니다. 이지패널에서 워드프레스 파일이 어디 있는지는 이지패널 설치 가이드를 참고하세요. 서버에 접속하는 데 쓰는 인증 정보는 애플리케이션 비밀번호 글에서 설명한 것처럼 용도별로 나눠 관리하는 것이 안전합니다.
오류 원인을 정확히 보는 법: 디버그 로그
흰 화면처럼 단서가 없을 때는 wp-config.php에 아래 설정을 넣어 오류를 파일로 남깁니다.
define( 'WP_DEBUG', true );define( 'WP_DEBUG_LOG', true );define( 'WP_DEBUG_DISPLAY', false );
이렇게 하면 오류가 방문자 화면에는 보이지 않고 wp-content/debug.log 파일에만 기록됩니다. 로그에 나온 파일 경로를 보면 어느 플러그인 폴더에서 오류가 났는지 바로 알 수 있습니다. 문제를 해결한 뒤에는 WP_DEBUG를 다시 false로 바꿔 둡니다. 설정 방법은 워드프레스 개발자 문서의 디버깅 안내에서 확인할 수 있습니다.
업데이트 오류를 줄이는 습관
- 업데이트 전 백업: 파일과 데이터베이스를 함께 백업합니다. 문제가 생겨도 백업이 있으면 몇 분 만에 되돌릴 수 있습니다.
- 한 번에 몰아서 업데이트하지 않기: 여러 개를 동시에 올리면 어느 것이 원인인지 찾기 어렵습니다. 중요한 플러그인은 하나씩 업데이트하고 사이트를 확인합니다.
- 자동 업데이트는 선별해서: 보안 패치가 중요한 플러그인만 자동 업데이트를 켜고, 페이지 빌더나 쇼핑몰처럼 사이트 구조에 큰 영향을 주는 플러그인은 직접 확인하며 올립니다.
- 오래 관리되지 않은 플러그인 정리: 마지막 업데이트가 오래된 플러그인은 새 버전 워드프레스와 맞지 않을 가능성이 큽니다.
자주 묻는 질문
플러그인을 삭제하면 설정도 사라지나요?
비활성화는 설정을 남겨 두지만, 삭제는 플러그인에 따라 설정과 데이터까지 지울 수 있습니다. 원인을 찾는 단계에서는 삭제보다 비활성화를 쓰세요.
복구 모드 이메일이 오지 않아요.
서버의 메일 발송이 막혀 있거나 스팸함으로 갔을 수 있습니다. 이럴 때는 plugins 폴더 이름을 바꾸는 방법을 쓰면 됩니다.
테마 때문에 생긴 오류도 같은 방법으로 찾나요?
비슷합니다. themes 폴더 안의 현재 테마 폴더 이름을 바꾸면 워드프레스가 기본 테마로 전환합니다. 기본 테마가 설치되어 있어야 합니다.
캐시 플러그인을 끄면 사이트가 느려지지 않나요?
원인을 찾는 동안만 잠시 끄는 것이라 괜찮습니다. 원인을 찾은 뒤 다시 켜고 캐시를 비우면 원래 속도로 돌아옵니다.
플러그인 업데이트를 되돌릴 수 있나요?
워드프레스 공식 디렉터리의 플러그인은 대부분 이전 버전 파일을 내려받을 수 있습니다. 이전 버전 zip을 받아 업로드하면 되돌릴 수 있지만, 보안 업데이트였다면 문제를 해결한 뒤 다시 최신 버전으로 올려야 합니다.



