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