워드프레스를 운영하다 보면 플러그인을 설치하거나 업데이트한 뒤 갑자기 화면이 깨지는 일이 생길 수 있습니다. 관리자 화면에 들어가지지 않거나, 글 편집기가 열리지 않고, 홈페이지에 “치명적인 오류가 발생했습니다”라는 메시지가 나타나기도 합니다.
이런 문제를 흔히 플러그인 충돌이라고 부릅니다. 플러그인 자체가 나쁜 제품이라서 발생하는 경우도 있지만, 워드프레스 버전이나 테마, 다른 플러그인, PHP 환경과 서로 맞지 않아 문제가 생기는 경우도 있습니다.
다행히 플러그인 충돌은 원인을 하나씩 좁혀 가면 해결할 수 있는 경우가 많습니다. 이번 글에서는 초보자도 따라 할 수 있도록 충돌이 발생하는 이유와 증상, 관리자 화면에 접속할 수 있을 때의 복구 방법, 접속할 수 없을 때의 대처 방법을 순서대로 설명하겠습니다.
1. 워드프레스 플러그인 충돌이란 무엇인가요?
플러그인은 워드프레스에 새로운 기능을 추가하는 프로그램입니다. 문의 양식, 백업, 보안, SEO, 캐시, 이미지 압축 등 다양한 기능을 추가할 수 있지만, 여러 프로그램이 동시에 작동하면서 같은 부분을 수정하려고 하면 충돌이 발생할 수 있습니다.
예를 들어 두 개의 캐시 플러그인이 같은 페이지 캐시를 관리하거나, 두 개의 SEO 플러그인이 동일한 메타 정보를 출력하면 예상하지 못한 문제가 생길 수 있습니다. 테마가 특정 플러그인의 기능을 사용하는 경우에는 테마와 플러그인의 버전이 맞지 않아 오류가 나타나기도 합니다.
플러그인 충돌은 한 가지 원인으로만 발생하지 않습니다. 최근에 설치하거나 업데이트한 항목부터 확인하고, 플러그인과 테마를 하나씩 분리해서 점검하는 과정이 필요합니다.
2. 플러그인 충돌이 발생했을 때 나타나는 증상
충돌이 발생하면 사이트 전체에 문제가 생길 수도 있고, 특정 기능만 작동하지 않을 수도 있습니다. 아래와 같은 증상이 최근 플러그인 설치나 업데이트 직후 나타났다면 충돌 가능성을 살펴보세요.
- 홈페이지가 하얀 화면으로 표시됩니다.
- 관리자 페이지에 로그인할 수 없습니다.
- “치명적인 오류가 발생했습니다”라는 안내가 나타납니다.
- 글쓰기 화면이나 블록 편집기가 정상적으로 열리지 않습니다.
- 메뉴, 위젯, 이미지, 문의 양식이 갑자기 표시되지 않습니다.
- 사이트가 느려지거나 특정 페이지에서만 멈춥니다.
- 모바일 화면의 글자나 이미지 배치가 깨집니다.
- 예약 글이나 자동 작업이 정상적으로 실행되지 않습니다.
- 플러그인 활성화 직후 관리자 화면에서 오류가 발생합니다.
문제가 발생한 시점도 중요합니다. 며칠 전부터 서서히 이상해졌는지, 특정 플러그인을 설치한 직후 바로 문제가 발생했는지 기록해 보세요. 최근에 변경한 내용이 원인을 찾는 중요한 단서가 됩니다.
3. 플러그인 충돌이 발생하는 주요 원인
| 원인 | 설명 | 확인할 내용 |
|---|---|---|
| 최근 플러그인 업데이트 | 새 버전의 코드가 기존 환경과 맞지 않을 수 있습니다. | 업데이트 직후 오류가 시작되었는지 확인합니다. |
| 플러그인끼리의 기능 중복 | 같은 기능을 제공하는 제품이 서로 다른 설정을 적용할 수 있습니다. | 캐시, SEO, 보안 플러그인이 여러 개 설치되었는지 확인합니다. |
| 테마와의 충돌 | 테마가 특정 플러그인의 코드나 기능을 지원하지 않을 수 있습니다. | 기본 테마로 바꿨을 때 문제가 사라지는지 확인합니다. |
| 워드프레스 버전 문제 | 플러그인이 현재 워드프레스 버전과 호환되지 않을 수 있습니다. | 플러그인 안내 페이지의 호환성 정보를 확인합니다. |
| 서버 PHP 환경 | 플러그인이 요구하는 PHP 버전이나 서버 설정과 다를 수 있습니다. | 호스팅 업체의 PHP 버전과 오류 기록을 확인합니다. |
| 캐시가 남아 있는 경우 | 문제를 수정했어도 이전 오류 화면이 계속 보일 수 있습니다. | 사이트·브라우저·서버 캐시를 순서대로 확인합니다. |
4. 복구 전에 먼저 해야 할 일
문제를 해결하려고 여러 설정을 한꺼번에 변경하면 원인을 더 찾기 어려워집니다. 먼저 현재 상황을 기록하고, 가능하다면 백업을 준비하세요.
- 오류가 발생한 날짜와 시간을 적어 둡니다.
- 최근 설치하거나 업데이트한 플러그인 이름을 확인합니다.
- 화면에 표시된 오류 문구를 그대로 저장합니다.
- 관리자 화면과 방문자 화면 중 어디에서 문제가 발생하는지 구분합니다.
- 호스팅의 자동 백업 또는 수동 백업 기능을 확인합니다.
로그인 자체가 되지 않는 상황에서는 무리하게 파일을 삭제하지 않는 것이 좋습니다. 먼저 플러그인 폴더의 이름을 바꿔 일시적으로 작동을 중단하는 방법을 우선 검토하세요. 이 방식은 원본 파일을 바로 없애지 않고 문제를 확인할 수 있다는 장점이 있습니다.
5. 관리자 화면에 접속할 수 있을 때 해결하는 방법
첫 번째 단계: 최근 변경 사항 확인
가장 먼저 최근에 설치하거나 업데이트한 플러그인을 확인합니다. 문제가 특정 변경 직후 발생했다면 해당 플러그인을 우선 비활성화해 보세요.
- 워드프레스 관리자 화면에 로그인합니다.
- 플러그인 → 설치한 플러그인으로 이동합니다.
- 최근 변경한 플러그인을 찾습니다.
- 플러그인 이름 아래의 비활성화를 누릅니다.
- 홈페이지와 문제가 발생한 페이지를 새로 확인합니다.
비활성화 후 문제가 사라졌다면 해당 플러그인이 직접적인 원인이거나 다른 기능과 충돌했을 가능성이 있습니다. 이때 바로 삭제하기보다 플러그인의 업데이트 내역과 지원 게시판에서 같은 오류가 보고되었는지 확인하는 것이 좋습니다.
두 번째 단계: 모든 플러그인 비활성화
원인을 특정하기 어렵다면 모든 플러그인을 임시로 비활성화합니다. 관리자 화면에서 여러 플러그인을 선택한 뒤 일괄 작업으로 비활성화할 수 있습니다.
- 플러그인 → 설치한 플러그인으로 이동합니다.
- 목록 위쪽의 선택 상자를 눌러 플러그인을 선택합니다.
- 일괄 작업 메뉴에서 비활성화를 선택합니다.
- 적용을 누릅니다.
- 문제가 발생했던 페이지를 다시 확인합니다.
모든 플러그인을 껐을 때 문제가 사라진다면 플러그인 중 하나가 원인일 가능성이 높습니다. 이제 플러그인을 모두 동시에 켜지 말고 하나씩 활성화하면서 매번 홈페이지와 문제가 발생했던 기능을 확인하세요.
어떤 플러그인을 활성화한 직후 오류가 다시 나타난다면 해당 플러그인 이름을 기록합니다. 그 플러그인을 비활성화한 상태에서 나머지 플러그인을 계속 확인하면 단일 충돌인지, 여러 플러그인의 조합 문제인지 파악하기 쉽습니다.
세 번째 단계: 테마 충돌 확인
모든 플러그인을 비활성화했는데도 문제가 계속된다면 테마와의 충돌을 확인해야 합니다. 사용 중인 테마를 잠시 기본 테마로 변경한 뒤 문제가 사라지는지 살펴보세요.
기본 테마에서 문제가 사라진다면 테마의 코드나 테마와 플러그인의 연결 부분에 문제가 있을 수 있습니다. 이 경우 테마를 즉시 삭제하기보다 테마 제작자의 업데이트 내역과 지원 문서를 확인하세요.
테마를 바꾸기 전에는 사용자 정의 메뉴, 위젯, 로고, 색상, 추가 CSS 등이 어떻게 표시되는지 기억해 두는 것이 좋습니다. 테마를 잠시 테스트한 뒤 원래 테마로 돌아갈 수 있도록 준비하세요.
6. 관리자 화면에 접속할 수 없을 때
복구 모드 이메일 확인
치명적인 오류가 발생하면 워드프레스에서 관리자 이메일 주소로 복구 모드 안내를 보내는 경우가 있습니다. 이메일 안의 특별한 로그인 링크를 이용하면 문제를 일으킨 플러그인이나 테마를 일시적으로 멈춘 상태에서 관리자 화면에 들어갈 수 있습니다.
복구 모드로 접속한 뒤 오류 안내에 표시된 플러그인을 확인하고, 해당 플러그인을 비활성화하거나 설정을 수정합니다. 복구 이메일이 보이지 않는다면 스팸함과 관리자 계정의 이메일 주소를 함께 확인하세요.
FTP 또는 호스팅 파일 관리자로 플러그인 중단
복구 모드로도 들어갈 수 없다면 FTP 프로그램이나 호스팅에서 제공하는 파일 관리자를 사용할 수 있습니다. 이 방법은 파일 위치를 잘못 변경하면 다른 문제가 생길 수 있으므로, 정확한 폴더를 확인하면서 진행해야 합니다.
- FTP 또는 호스팅 파일 관리자에 접속합니다.
- 워드프레스가 설치된 위치에서
wp-content폴더를 찾습니다. - 그 안의
plugins폴더를 확인합니다. - 특정 플러그인이 의심되면 해당 플러그인 폴더 이름 뒤에
-old를 붙입니다. - 관리자 로그인과 홈페이지 접속을 다시 확인합니다.
예를 들어 폴더 이름이 plugin-name이라면 plugin-name-old처럼 변경할 수 있습니다. 워드프레스가 원래 플러그인 폴더를 찾지 못하면 해당 플러그인을 자동으로 비활성화할 수 있습니다.
원인을 특정할 수 없고 관리자 화면에도 들어갈 수 없다면 plugins 폴더 전체 이름을 plugins-old처럼 변경해 모든 플러그인을 잠시 중단할 수 있습니다. 관리자 화면에 다시 접속한 후에는 폴더 이름을 원래 plugins로 되돌리고, 플러그인을 하나씩 활성화해 원인을 찾습니다.
이 방법은 폴더를 삭제하는 작업이 아닙니다. 파일을 지우지 않고 이름을 변경하는 방식이므로, 문제가 해결되지 않았을 때 원래 이름으로 되돌릴 수 있습니다.
7. 플러그인과 테마를 구분해 진단하는 방법
플러그인을 모두 중단했는데도 오류가 계속되면 플러그인이 원인이 아닐 수 있습니다. 다음 순서로 범위를 좁혀 보세요.
- 플러그인을 모두 비활성화하고 문제가 계속되는지 확인합니다.
- 기본 테마로 변경하고 문제가 사라지는지 확인합니다.
- 기본 테마에서도 문제가 발생하면 호스팅 오류나 워드프레스 파일 문제를 확인합니다.
- 특정 페이지에서만 문제가 발생하면 해당 페이지의 블록, 숏코드, 사용자 정의 코드도 확인합니다.
- 최근 PHP 버전이나 서버 설정이 변경되었는지 호스팅 업체에 문의합니다.
문제가 플러그인 전체가 아니라 특정 기능에서만 나타난다면 해당 기능이 사용하는 플러그인과 테마의 연결 부분을 살펴봐야 합니다. 예를 들어 결제 버튼만 작동하지 않는다면 모든 플러그인을 의심하기보다 결제 관련 플러그인, 캐시 예외 설정, 보안 차단 여부를 먼저 확인하는 방식입니다.
8. 충돌 원인을 찾은 뒤의 처리 방법
문제를 일으킨 플러그인을 찾았다면 다음 중 사이트 상황에 맞는 방법을 선택합니다.
업데이트를 기다리는 경우
플러그인 제작자가 이미 오류를 확인하고 수정 버전을 준비하고 있다면, 임시로 비활성화한 채 업데이트를 기다릴 수 있습니다. 다만 업데이트 일정이 정해져 있지 않다면 장기간 방치하지 말고 다른 제품으로 교체할지 검토하세요.
이전 버전으로 되돌리는 경우
업데이트 직후 오류가 발생했다면 이전 버전에서 정상적으로 작동했을 가능성이 있습니다. 일부 관리 도구나 플러그인은 이전 버전으로 되돌리는 기능을 제공하지만, 되돌리기 전에는 반드시 백업을 준비해야 합니다.
플러그인을 교체하는 경우
사이트에서 꼭 필요한 기능이라면 같은 목적의 다른 플러그인을 비교할 수 있습니다. 기능이 비슷하다고 무조건 여러 제품을 동시에 설치하지 말고, 기존 플러그인의 설정과 데이터를 내보낼 수 있는지 확인한 뒤 교체하세요.
플러그인을 삭제하는 경우
더 이상 필요하지 않은 플러그인은 비활성화 후 삭제할 수 있습니다. 다만 삭제 과정에서 설정과 저장 데이터가 함께 제거되는 제품도 있으므로, 문의 내용이나 중요한 설정이 있다면 먼저 백업하거나 내보내기를 진행하세요.
9. 충돌을 예방하는 관리 습관
플러그인 충돌을 완전히 없앨 수는 없지만, 문제가 발생할 가능성과 복구 시간을 줄일 수는 있습니다.
- 필요한 기능만 설치하고 사용하지 않는 플러그인은 정리합니다.
- 같은 기능을 제공하는 플러그인을 여러 개 설치하지 않습니다.
- 플러그인 업데이트 전 사이트 백업을 준비합니다.
- 중요한 사이트는 테스트 환경에서 먼저 업데이트합니다.
- 여러 플러그인을 한꺼번에 업데이트하지 않고 변경 후 화면을 확인합니다.
- 워드프레스, 테마, 플러그인의 호환성 정보를 확인합니다.
- 관리자 이메일 주소가 최신 상태인지 확인합니다.
- 캐시를 사용하는 경우 수정 후 캐시를 비우고 다시 확인합니다.
플러그인을 설치한 날짜와 목적을 간단히 기록해 두는 것도 좋습니다. 문제가 발생했을 때 최근 변경 내역을 빠르게 확인할 수 있기 때문입니다. 특히 자동 업데이트를 사용하는 경우에는 이메일 알림이나 관리자 화면의 업데이트 기록을 정기적으로 확인하세요.
10. 초보자가 자주 하는 실수
첫 번째 실수는 오류가 발생하자마자 플러그인 폴더를 삭제하는 것입니다. 삭제하면 문제는 사라질 수 있지만, 설정과 저장된 데이터까지 잃을 수 있습니다. 먼저 비활성화나 폴더 이름 변경으로 작동만 중단하는 것이 안전합니다.
두 번째 실수는 모든 플러그인을 동시에 다시 활성화하는 것입니다. 이렇게 하면 문제가 재발했을 때 어떤 플러그인이 원인이었는지 알 수 없습니다. 하나를 활성화하고 관련 기능을 확인한 다음 다음 플러그인으로 넘어가세요.
세 번째 실수는 브라우저에 보이는 오류 화면만 보고 복구가 끝났다고 판단하는 것입니다. 관리자 화면이 열려도 글쓰기, 모바일 화면, 문의 양식, 로그인, 메뉴 등 주요 기능을 직접 테스트해야 합니다.
네 번째 실수는 플러그인 문제라고 단정하는 것입니다. 호스팅의 PHP 버전, 서버 용량, SSL 설정, 테마 코드, 캐시 문제도 비슷한 증상을 만들 수 있습니다. 하나씩 범위를 좁혀야 정확한 원인을 찾을 수 있습니다.
마무리
워드프레스 플러그인 충돌이 발생했을 때는 당황해서 파일을 바로 삭제하기보다 최근 변경 사항을 확인하고, 백업을 준비한 뒤 하나씩 원인을 분리하는 것이 중요합니다.
관리자 화면에 접속할 수 있다면 모든 플러그인을 비활성화한 뒤 하나씩 다시 활성화하면서 문제를 찾을 수 있습니다. 관리자 화면에 접속할 수 없다면 복구 모드 이메일을 확인하거나 FTP와 호스팅 파일 관리자를 이용해 플러그인 폴더 이름을 임시로 변경할 수 있습니다.
플러그인 충돌 해결의 핵심은 비활성화, 확인, 하나씩 재활성화하는 과정입니다. 원인을 찾은 뒤에는 업데이트, 교체, 삭제 중 사이트에 맞는 방법을 선택하고, 복구가 끝난 후에는 주요 페이지와 모바일 화면까지 직접 확인하세요.
참고 자료
글에 대한 의견이나 정정 요청은 문의하기로 보내주세요.
문의하기


