WordPress 백색 화면 오류 수정하기

"WordPress 흰 화면 죽음(White Screen of Death)" 오류를 해결하는 방법

"흰 화면 죽음"은 WordPress 사이트에서 오류 메시지 없이 빈 흰 페이지만 표시되는 상황입니다. 이것은 원인에 대한 가시적인 단서를 제공하지 않기 때문에 더욱 답답한 WordPress 문제 중 하나입니다. 이 가이드는 가장 일반적인 원인과 각각을 해결하는 방법을 안내합니다.

Step 1: 에러 로그 확인

가장 먼저 할 일은 PHP 에러 로그를 확인하는 것이며, 이는 보통 정확한 원인을 나타냅니다:

1. KPanel (kpanel.kapsulehost.com)에 로그인
2. Websites로 이동하여 사이트를 선택한 후 Logs 클릭
3. PHP Error Log 열기
4. 흰 화면이 시작된 시간 근처의 Fatal error 항목 찾기

자세한 내용은 웹사이트 에러 로그 접근을 참조하세요.

Step 2: WordPress 디버그 모드 활성화

에러 로그에서 충분한 상세 정보가 표시되지 않으면 WordPress 디버그 모드를 활성화하세요:

1. SFTP 또는 KPanel 파일 관리자를 통해 연결
2. wp-config.php 열기
3. 다음을 설정:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

1. 페이지를 다시 로드하고 wp-content/debug.log에서 오류 메시지 확인

Step 3: 모든 플러그인 비활성화

잘못된 플러그인이나 호환되지 않는 플러그인은 업데이트 후 흰 화면이 발생하는 가장 일반적인 원인입니다.

WordPress 관리자 페이지에 접근할 수 있으면: Plugins > Installed Plugins로 이동하여 모두 선택한 후 일괄 작업 메뉴에서 Deactivate를 선택합니다.

WordPress 관리자 페이지에 접근할 수 없으면:

1. SFTP를 통해 사이트에 연결
2. wp-content/plugins/로 이동
3. plugins 폴더를 plugins-disabled로 이름 변경
4. 사이트 로드 시도

흰 화면이 사라지면 플러그인이 원인입니다. 폴더를 plugins로 다시 이름 변경한 후, 문제가 되는 플러그인을 찾을 때까지 한 번에 하나씩 플러그인을 비활성화합니다.

Step 4: 기본 테마로 전환

손상된 테마도 흰 화면을 유발할 수 있습니다:

1. SFTP를 통해 wp-content/themes/로 이동
2. 활성 테마의 폴더를 mytheme-disabled과 같은 이름으로 변경
3. WordPress가 기본 테마로 폴백됩니다

Step 5: PHP 메모리 제한 증가

WordPress의 메모리 부족 시 흰 화면이 발생할 수 있습니다. 제한을 증가시키려면:

1. 파일 관리자 또는 SFTP를 통해 wp-config.php 열기
2. /* That's all, stop editing! */ 줄 앞에 다음 줄 추가:

define( 'WP_MEMORY_LIMIT', '256M' );

1. 파일을 저장하고 사이트 다시 로드

KPanel의 Websites > [your site] > PHP Settings에서도 PHP 메모리 제한을 증가시킬 수 있습니다.

Step 6: 백업에서 복원

위의 단계 중 어느 것도 문제를 해결하지 못하면, 문제가 발생하기 전에 만든 백업에서 복원하는 것이 가장 빠른 해결 방법입니다. 백업에서 복원을 참조하세요.

여전히 해결되지 않음?

이 단계들을 모두 거쳤음에도 흰 화면이 계속되면, KPanel의 Support에서 지원 티켓을 여세요. 최근의 PHP 에러 로그 항목과 문제 발생 전에 사이트에서 변경된 사항에 대한 설명을 포함하세요.