"white screen of death(죽음의 백색 화면)"는 WordPress 사이트에 오류 메시지 없이 빈 흰색 페이지만 표시되는 현상입니다. 원인을 알려주는 단서가 전혀 보이지 않기 때문에 가장 당혹스러운 WordPress 문제 중 하나입니다. 이 가이드에서는 가장 흔한 원인과 각각을 해결하는 방법을 살펴봅니다.
1단계: 오류 로그 확인
가장 먼저 해야 할 일은 PHP 오류 로그를 확인하는 것입니다. 보통 여기서 정확한 원인을 알 수 있습니다:
- kpanel.kapsulehost.com에서 KPanel에 로그인합니다
- 웹사이트로 이동해 사이트를 선택한 뒤 로그를 클릭합니다
- PHP 오류 로그를 엽니다
- 흰 화면이 시작된 시점 근처의
Fatal error항목을 찾습니다
자세한 내용은 웹사이트 오류 로그 확인하기를 참고하세요.
2단계: WordPress 디버그 모드 활성화
오류 로그에 충분한 정보가 표시되지 않는다면 WordPress 디버그 모드를 활성화하세요:
- SFTP 또는 KPanel 파일 관리자를 통해 접속합니다
wp-config.php파일을 엽니다- 다음과 같이 설정합니다:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
- 페이지를 새로고침하고
wp-content/debug.log에서 오류 메시지를 확인합니다
3단계: 모든 플러그인 비활성화
업데이트 후 흰 화면이 발생하는 가장 흔한 원인은 결함이 있거나 호환되지 않는 플러그인입니다.
WordPress 관리자에 접속할 수 있는 경우: Plugins > Installed Plugins로 이동해 모두 선택한 뒤 일괄 작업 메뉴에서 Deactivate를 선택합니다.
WordPress 관리자에 접속할 수 없는 경우:
- SFTP를 통해 사이트에 접속합니다
wp-content/plugins/로 이동합니다plugins폴더 이름을plugins-disabled(으)로 변경합니다- 사이트를 다시 불러와 봅니다
흰 화면이 사라지면 플러그인이 원인입니다. 폴더 이름을 다시 plugins(으)로 되돌린 뒤, 문제를 일으키는 플러그인을 찾을 때까지 플러그인을 하나씩 비활성화해 보세요.
4단계: 기본 테마로 전환
손상된 테마도 흰 화면의 원인이 될 수 있습니다:
- SFTP를 통해
wp-content/themes/로 이동합니다 - 사용 중인 테마 폴더의 이름을
mytheme-disabled처럼 변경합니다 - 그러면 WordPress가 기본 테마로 대체됩니다
문제를 일으킨 플러그인이나 테마를 찾아낸 후에는 개발사에서 업데이트가 제공되는지 확인하세요. 많은 흰 화면 문제가 다음 릴리스에서 수정됩니다.
5단계: PHP 메모리 한도 늘리기
WordPress가 메모리를 모두 소진하면 흰 화면이 발생할 수 있습니다. 한도를 늘리려면:
- 파일 관리자 또는 SFTP로
wp-config.php을 엽니다 /* That's all, stop editing! */줄 앞에 다음 줄을 추가합니다:
define( 'WP_MEMORY_LIMIT', '256M' );
- 파일을 저장하고 사이트를 새로고침합니다
KPanel의 Websites > [해당 사이트] > Settings > PHP에서도 PHP 메모리 한도를 늘릴 수 있습니다.
6단계: 백업에서 복원
위의 단계로도 문제가 해결되지 않는다면, 문제가 시작되기 전에 생성된 백업에서 복원하는 것이 가장 빠른 해결 방법입니다. 백업에서 복원하기를 참고하세요.
그래도 해결되지 않나요?
이 단계들을 모두 수행한 후에도 흰 화면이 계속된다면 KPanel의 지원에서 지원 티켓을 열어주세요. 가장 최근의 PHP 오류 로그 항목과 문제가 발생하기 전 사이트에서 변경된 사항에 대한 설명을 함께 첨부해 주세요.