워드프레스 플러그인 오류는 새 기능을 추가하거나 플러그인을 업데이트한 직후 나타날 수 있다. 사이트 첫 화면이 흰 화면으로 바뀌거나 치명적인 오류 안내가 나오고, 관리자 페이지까지 열리지 않을 때도 있다.
워드프레스 플러그인 오류가 발생했다고 해서 사이트의 글과 이미지가 모두 삭제된 것은 아니다. 플러그인의 PHP 코드가 현재 워드프레스, 테마 또는 서버 환경과 충돌해 사이트 실행이 중단된 경우가 많다.
이때 플러그인 파일이나 데이터베이스부터 삭제하면 문제의 원인을 찾기 어려워질 수 있다. 최근 설치한 플러그인을 관리자 화면, 복구 이메일, 파일 관리자와 FTP 순서로 확인해야 한다.
이 글에서는 워드프레스 플러그인 오류로 사이트가 열리지 않을 때 초보자가 안전하게 복구하는 4가지 방법을 정리한다.
워드프레스 플러그인 오류는 왜 생길까?
플러그인은 워드프레스에 새로운 기능을 추가하는 프로그램이다. 플러그인은 테마, 다른 플러그인, PHP와 함께 실행되기 때문에 환경이 맞지 않으면 사이트가 멈출 수 있다.
대표적인 원인은 다음과 같다.
- 현재 워드프레스 버전과 맞지 않는 플러그인
- 두 플러그인이 같은 기능을 동시에 실행하는 충돌
- 테마와 플러그인의 코드 충돌
- 현재 PHP 버전을 지원하지 않는 플러그인
- PHP 메모리 부족이나 서버 자원 제한
- 설치 또는 업데이트 중 손상된 파일
플러그인을 설치하거나 업데이트한 직후 오류가 시작됐다면 해당 플러그인을 우선 확인할 수 있다. 다만 정확한 원인은 플러그인을 비활성화한 뒤 사이트가 다시 열리는지 확인해야 알 수 있다.
1. 관리자 화면에서 최근 플러그인을 비활성화한다
관리자 페이지에 들어갈 수 있다면 가장 안전한 방법부터 시작한다. 워드프레스 관리자에서 플러그인 → 설치한 플러그인으로 이동한다.
- 오류가 발생하기 직전에 설치하거나 업데이트한 플러그인을 찾는다.
- 플러그인 아래의 비활성화를 누른다.
- 사이트 첫 화면과 주요 글을 다시 연다.
- 사이트가 정상으로 돌아오면 플러그인을 바로 삭제하지 말고 원인을 확인한다.
여러 플러그인을 한꺼번에 변경했다면 하나씩 비활성화해야 한다. 여러 개를 동시에 끄면 어떤 플러그인에서 문제가 시작됐는지 확인하기 어렵다.
먼저 확인해야 한다.
플러그인을 삭제하거나 파일을 수정하기 전에 사이트 파일과 데이터베이스를 백업해야 한다. 쇼핑몰, 예약, 회원, 보안 플러그인은 비활성화하는 동안 관련 기능이 멈출 수 있다.
2. 관리자 이메일에서 복구 링크를 확인한다
플러그인 때문에 치명적인 문제가 발생하면 워드프레스가 관리자 이메일로 복구 링크를 보낼 수 있다. 메일에는 오류가 발생한 플러그인 이름이나 파일 경로가 표시되기도 한다.
다음 위치를 확인한다.
- 사이트 관리자 이메일의 받은편지함
- 스팸 메일함과 프로모션함
- 호스팅 가입에 사용한 이메일
- 워드프레스 설치 당시 등록한 이메일
복구 링크로 들어가면 문제가 생긴 플러그인이 일시 중지된 상태에서 관리자 화면을 열 수 있다. 관리자 화면이 열리면 해당 플러그인을 비활성화하고 사이트를 확인한다.
복구 이메일이 오지 않았다면 오래된 관리자 이메일이나 서버의 메일 발송 문제가 원인일 수 있다. 이 경우 파일 관리자 또는 FTP를 이용한다.
3. 파일 관리자에서 플러그인 폴더 이름을 바꾼다
관리자 페이지까지 열리지 않는다면 호스팅 파일 관리자나 FTP를 이용할 수 있다. 워드프레스가 설치된 폴더에서 다음 경로를 찾는다.
/wp-content/plugins/그 안에서 오류가 발생한 플러그인 폴더를 찾는다. 예를 들어 폴더 이름이 다음과 같다고 가정한다.
sample-plugin폴더 이름 뒤에 -disabled를 붙인다.
sample-plugin-disabled워드프레스가 기존 경로에서 플러그인을 찾지 못하면 해당 플러그인이 비활성화된다. 폴더 이름을 바꾼 뒤 사이트 첫 화면과 관리자 페이지가 열리는지 확인한다.
사이트가 다시 열린다면 워드프레스 플러그인 오류의 원인 후보를 찾은 것이다. 폴더 이름을 원래대로 되돌린 뒤 관리자 화면에서 해당 플러그인이 비활성화됐는지 확인한다.
주의: 플러그인 폴더를 바로 삭제하지 말아야 한다. 삭제하면 플러그인 내부 파일이 사라지고 복구가 어려워질 수 있다. 먼저 폴더 이름만 변경해 결과를 확인한다.
4. 원인을 모르면 전체 플러그인을 일시 중지한다
어떤 플러그인이 원인인지 모르거나 여러 플러그인을 동시에 업데이트했다면 전체 플러그인을 일시적으로 중지할 수 있다.
파일 관리자나 FTP에서 다음 폴더를 찾는다.
/wp-content/plugins/plugins 폴더 이름을 다음처럼 변경한다.
plugins-disabled사이트와 관리자 화면이 다시 열린다면 설치된 플러그인 중 하나가 원인일 가능성이 높다. 확인을 마치면 폴더 이름을 다시 plugins로 되돌린다.
관리자 화면에서 플러그인을 하나씩 활성화하면서 매번 사이트를 확인한다. 특정 플러그인을 켠 직후 오류가 다시 나타난다면 해당 플러그인을 비활성화한다.
워드프레스 공식 문서에서도 관리자 화면에 접근할 수 없을 때 파일 관리자나 FTP에서 플러그인 폴더 이름을 변경하는 방법을 안내한다. 자세한 내용은 워드프레스 공식 문제 해결 안내에서 확인할 수 있다.
워드프레스 플러그인 오류 복구 후 확인할 항목
사이트가 다시 열린 뒤 문제 플러그인을 바로 활성화하면 같은 오류가 반복될 수 있다. 워드프레스 플러그인 오류가 사라졌다면 다음 항목을 확인한다.
- 플러그인의 최근 업데이트 날짜
- 지원하는 워드프레스 버전
- 지원하는 PHP 버전
- 같은 기능을 가진 플러그인의 중복 설치 여부
- 테마와 플러그인의 호환 여부
- 공식 지원 게시판의 최근 오류 사례
오랫동안 업데이트되지 않았거나 현재 환경을 지원하지 않는 플러그인은 다른 플러그인으로 교체하는 편이 안전하다. 설치 수가 많다는 이유만으로 현재 사이트에서도 문제가 없다고 단정할 수는 없다.
워드프레스 플러그인 오류가 반복된다면 플러그인 이름, 오류 발생 시간, PHP 버전과 최근 변경 사항을 기록해 호스팅 고객센터에 전달한다.
자주 묻는 질문
플러그인 폴더 이름을 바꾸면 설정이 삭제되나?
폴더 이름을 바꾸는 것만으로 데이터베이스에 저장된 설정이 바로 삭제되지는 않는다. 다만 플러그인 기능은 중지된다. 점검을 마친 뒤 원래 폴더 이름으로 되돌려야 한다.
사이트가 복구되면 문제 플러그인을 다시 켜도 되나?
원인을 확인하지 않은 상태에서 바로 활성화하면 같은 오류가 다시 생길 수 있다. 플러그인의 업데이트 기록과 PHP 지원 버전을 확인한 뒤 백업 상태에서 시험하는 편이 좋다.
플러그인을 삭제하고 다시 설치하면 해결되나?
설치 파일이 손상된 경우에는 도움이 될 수 있다. 하지만 코드 충돌이나 호환 문제가 원인이라면 재설치 후에도 오류가 반복될 수 있다. 삭제 전에는 플러그인 설정과 관련 데이터를 먼저 확인해야 한다.
플러그인을 모두 꺼도 사이트가 열리지 않으면 어떻게 하나?
테마, PHP 환경, 워드프레스 핵심 파일이나 서버 문제를 확인해야 한다. 오류 발생 시간과 최근 변경 사항을 정리해 호스팅 고객센터에 PHP 오류 로그 확인을 요청한다.
워드프레스 플러그인 오류 해결 방법 정리
- 관리자 화면이 열리면 최근 설치한 플러그인을 먼저 비활성화한다.
- 관리자 이메일에서 워드프레스 복구 링크를 확인한다.
- 관리자 화면이 막혔다면 문제 플러그인 폴더 이름을 변경한다.
- 원인을 모르면 전체 플러그인을 중지한 뒤 하나씩 다시 활성화한다.
- 복구 후에는 플러그인의 워드프레스와 PHP 지원 조건을 확인한다.
워드프레스 플러그인 오류는 파일을 바로 삭제하기보다 최근 변경한 플러그인을 일시 중지하는 방식으로 접근해야 한다. 관리자 화면에서 시작하고, 접속이 불가능할 때만 파일 관리자나 FTP로 범위를 넓히는 편이 안전하다.
사이트 주소를 변경한 뒤 접속이 막혔다면 워드프레스 주소 변경 후 접속 안 될 때 복구하는 3가지 방법을 함께 확인한다.
지금 바로 할 일
오류가 시작되기 직전에 설치하거나 업데이트한 플러그인 이름을 기록한다. 관리자 화면이 열리면 해당 플러그인을 비활성화하고, 열리지 않는다면 호스팅 파일 관리자에서 플러그인 폴더 이름만 임시로 변경한다. 파일을 수정하기 전에는 반드시 백업부터 만든다.
