워드프레스 치명적인 오류는 사이트를 운영하다 보면 갑자기 마주칠 수 있다. 플러그인을 업데이트한 뒤 사이트가 열리지 않거나 관리자 페이지에 들어가려는데 오류 안내만 나타날 때가 있다. 방문자가 보는 화면과 관리자 화면이 동시에 막히면 사이트 전체가 사라진 것처럼 느껴질 수 있다.
하지만 치명적인 오류가 나타났다고 해서 글과 이미지가 모두 삭제된 것은 아니다. 플러그인이나 테마의 PHP 코드가 충돌하거나, 서버의 PHP 환경과 맞지 않아 워드프레스 실행이 중단된 경우가 많다.
이때 파일과 데이터베이스를 처음부터 수정하면 원인을 찾기 더 어려워질 수 있다. 복구 이메일, 최근 변경 사항, 플러그인처럼 되돌리기 쉬운 항목부터 확인해야 한다.
이 글에서는 워드프레스 치명적인 오류가 발생했을 때 초보자가 안전하게 확인할 5단계를 정리한다.
워드프레스 치명적인 오류는 왜 생길까?
워드프레스는 PHP를 이용해 테마, 플러그인, 관리자 기능을 실행한다. 이 과정에서 실행할 수 없는 코드가 발견되거나 필요한 메모리가 부족하면 작업이 중단될 수 있다.
대표적인 원인은 다음과 같다.
- 플러그인 업데이트 후 발생한 코드 충돌
- 테마와 플러그인의 호환 문제
- 현재 PHP 버전과 맞지 않는 기능
- 부족한 PHP 메모리
- 워드프레스 핵심 파일의 손상
- 직접 수정한 코드의 문법 오류
오류 화면만 보고 원인을 바로 단정하기는 어렵다. 오류가 발생하기 직전에 설치하거나 변경한 항목부터 확인하는 것이 중요하다.
1. 관리자 이메일에서 복구 링크를 확인한다
워드프레스는 일부 치명적 오류가 발생하면 사이트 관리자 이메일로 복구 안내를 보낸다. 메일 제목이나 내용에는 사이트에 기술적인 문제가 발생했다는 안내와 복구 모드 링크가 들어갈 수 있다.
먼저 다음 위치를 확인한다.
- 관리자 이메일의 받은편지함
- 스팸 메일함과 프로모션함
- 호스팅 가입 이메일
- 사이트를 처음 설치한 사람이 사용한 이메일
복구 링크로 접속하면 오류를 일으킨 플러그인이나 테마가 일시적으로 중지된 상태에서 관리자 화면에 들어갈 수 있다. 관리자 화면이 열리면 오류 안내에 표시된 항목을 확인하고 바로 삭제하기보다 먼저 비활성화한다.
복구 이메일이 오지 않는다면 설정 → 일반 → 관리자 이메일 주소가 현재 사용할 수 있는 주소인지 확인할 필요가 있다.
워드프레스 복구 모드의 작동 방식은 워드프레스 공식 복구 모드 안내에서 확인할 수 있다.
2. 오류가 발생하기 직전의 변경 사항을 되돌린다
워드프레스 치명적인 오류가 갑자기 시작됐다면 직전에 변경한 항목을 확인한다. 오류가 발생한 시점과 변경한 시간을 비교하면 원인을 좁히기 쉬워진다.
- 새 플러그인을 설치했는지
- 기존 플러그인을 업데이트했는지
- 테마를 변경하거나 업데이트했는지
- PHP 버전을 변경했는지
- 테마 파일이나 함수 코드를 수정했는지
- 워드프레스 자동 업데이트가 실행됐는지
관리자 화면에 들어갈 수 있다면 최근 변경한 플러그인을 하나씩 비활성화하고 사이트를 확인한다. 여러 플러그인을 한꺼번에 삭제하면 어떤 항목이 원인이었는지 알기 어려워진다.
먼저 확인해야 한다.
플러그인이나 테마를 삭제하기 전에 사이트 파일과 데이터베이스를 백업해야 한다. 기존 설정과 콘텐츠가 함께 삭제될 수 있으므로 먼저 비활성화한 뒤 결과를 확인한다.
3. 관리자 화면이 열리지 않으면 플러그인 폴더를 확인한다
관리자 화면에도 들어갈 수 없다면 호스팅 파일 관리자나 FTP를 이용해 플러그인을 일시적으로 비활성화할 수 있다.
워드프레스가 설치된 폴더에서 다음 경로를 찾는다.
/wp-content/plugins/plugins 폴더 이름을 다음처럼 임시로 바꾼다.
plugins-disabled폴더 이름을 바꾸면 워드프레스가 설치된 플러그인을 찾지 못해 전체 플러그인이 일시적으로 비활성화된다. 이후 사이트와 관리자 화면이 열리는지 확인한다.
사이트가 다시 열린다면 플러그인 중 하나가 원인일 가능성이 있다. 폴더 이름을 다시 plugins로 돌린 뒤 관리자 화면에서 플러그인을 하나씩 활성화하며 문제 항목을 찾는다.
특정 플러그인이 원인으로 확인되면 해당 플러그인의 공식 지원 문서와 업데이트 정보를 확인한다.
주의: wp-content 안의 다른 폴더를 삭제하거나 이름을 바꾸면 이미지, 테마, 업로드 파일에 문제가 생길 수 있다. 반드시 plugins 폴더만 확인한다.
4. 테마와 PHP 환경을 확인한다
플러그인을 모두 비활성화해도 워드프레스 치명적인 오류가 계속된다면 테마와 PHP 환경을 확인한다.
최근 테마를 업데이트하거나 테마의 functions.php 파일을 수정했다면 해당 변경이 원인일 수 있다. 관리자 화면에 들어갈 수 있다면 워드프레스 기본 테마로 잠시 변경해 사이트가 열리는지 확인한다.
테마를 바꿀 때는 메뉴, 위젯, 디자인 설정이 달라질 수 있으므로 현재 테마 이름과 설정 화면을 미리 기록한다.
PHP 환경은 관리자 화면의 도구 → 사이트 건강 → 정보 → 서버에서 확인할 수 있다. 관리자 화면이 열리지 않는다면 호스팅 관리 화면이나 고객센터를 이용한다.
- 현재 PHP 버전이 테마와 플러그인에서 지원되는지
- PHP 버전을 변경한 직후 오류가 시작됐는지
- PHP 메모리 제한에 도달했는지
- 서버 오류 로그에 같은 메시지가 반복되는지
PHP 버전을 임의로 여러 번 변경하기보다 호스팅 고객센터에 현재 버전, 오류 발생 시간, 최근 변경 사항을 함께 전달하는 편이 안전하다.
5. 오류 기록을 확인하고 복구를 요청한다
플러그인과 테마를 확인해도 원인이 드러나지 않으면 PHP 오류 기록을 확인해야 한다. 오류 기록에는 문제가 발생한 파일 경로와 코드 줄 번호가 표시될 수 있다.
워드프레스에는 오류를 기록하는 디버그 기능이 있지만 운영 중인 사이트에서는 화면에 오류를 그대로 표시하지 않는 편이 안전하다. 방문자에게 서버 경로와 코드 정보가 노출될 수 있기 때문이다.
wp-config.php를 수정할 수 있고 전체 백업이 준비된 경우 다음 설정으로 오류를 파일에 기록할 수 있다.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );설정은 wp-config.php에서 다음 문장보다 위쪽에 넣는다.
/* That's all, stop editing! Happy publishing. */오류가 다시 발생한 뒤 다음 파일을 확인한다.
/wp-content/debug.log점검을 마치면 디버그 기능을 다시 끈다.
define( 'WP_DEBUG', false );워드프레스 디버그 설정의 자세한 내용은 워드프레스 공식 디버그 안내에서 확인할 수 있다.
주의: 같은 설정이 wp-config.php에 이미 있다면 중복해서 추가하지 말아야 한다. 파일을 수정하기 전 원본을 내려받아 보관하고, 확신이 없다면 호스팅 고객센터에 오류 로그 확인을 요청한다.
복구 후 반드시 확인할 항목
사이트가 다시 열린다고 해서 바로 점검을 끝내면 같은 오류가 반복될 수 있다.
- 사이트 첫 화면과 주요 글을 확인한다.
- 관리자 화면에서 글 저장을 시험한다.
- 오류를 일으킨 플러그인이나 테마를 다시 활성화하지 않는다.
- 워드프레스와 플러그인의 호환 정보를 확인한다.
- 사이트 건강 상태에서 치명적인 문제를 확인한다.
- 전체 백업을 새로 만든다.
- 관리자 이메일 주소가 정상인지 확인한다.
오류가 발생한 플러그인을 다시 사용해야 한다면 최신 버전과 PHP 지원 조건을 확인한 뒤 별도의 백업 상태에서 시험한다.
자주 묻는 질문
워드프레스 치명적인 오류가 뜨면 글이 모두 삭제된 것인가?
오류 메시지만으로 글과 이미지가 삭제됐다고 볼 수는 없다. PHP 실행이 중단돼 화면을 표시하지 못하는 경우가 많다. 데이터베이스와 업로드 폴더를 삭제하지 않았다면 콘텐츠가 남아 있을 가능성이 있다.
복구 이메일이 오지 않는 이유는 무엇인가?
관리자 이메일 주소가 오래된 주소이거나 메일이 스팸함으로 분류됐을 수 있다. 호스팅 서버에서 이메일 발송이 정상적으로 작동하지 않는 경우도 있다. 관리자 이메일과 호스팅 메일 기록을 함께 확인해야 한다.
플러그인 폴더 이름을 바꾸면 데이터가 삭제되나?
폴더 이름을 변경하는 것만으로 플러그인 데이터가 바로 삭제되지는 않는다. 다만 플러그인 기능이 중지되면서 쇼핑몰, 예약, 보안 기능이 작동하지 않을 수 있다. 점검이 끝나면 원래 이름으로 되돌려야 한다.
오류가 발생한 플러그인을 삭제해도 되나?
원인이 확인되기 전에는 바로 삭제하지 않는 편이 좋다. 플러그인에 저장된 설정이나 관련 데이터가 함께 제거될 수 있다. 먼저 비활성화하고 백업한 뒤 공식 지원 문서를 확인한다.
워드프레스 치명적인 오류 핵심 정리
- 관리자 이메일에서 복구 모드 링크를 먼저 확인한다.
- 오류 직전에 변경한 플러그인과 테마를 확인한다.
- 관리자 화면이 열리지 않으면 플러그인 폴더를 임시로 변경한다.
- 테마와 PHP 버전, 메모리 환경을 점검한다.
- 오류 기록을 확인한 뒤 호스팅 고객센터에 복구를 요청한다.
워드프레스 치명적인 오류는 무작정 파일을 삭제하는 것보다 변경 사항을 하나씩 되돌리는 방식으로 접근해야 한다. 복구 이메일과 플러그인을 먼저 확인하고, 해결되지 않을 때 테마와 PHP, 오류 기록으로 범위를 넓혀야 한다.
오류가 사이트 주소를 변경한 뒤 시작됐다면 워드프레스 주소 변경 후 접속 안 될 때 복구하는 3가지 방법을 함께 확인한다.
지금 바로 할 일
관리자 이메일과 스팸함에서 워드프레스 복구 안내를 먼저 찾는다. 메일이 없다면 오류가 발생하기 직전에 업데이트한 플러그인과 테마를 기록한다. 파일을 수정해야 한다면 호스팅 백업부터 만든 뒤 진행한다.
