흰 화면 오류 해결 방법을 알면 사이트 다운을 5분 안에 복구합니다

워드프레스 흰 화면(WSOD, White Screen of Death) 해결은 워드프레스 관리자라면 반드시 알아야 하는 응급처치입니다. 플러그인 업데이트 직후나 새 테마 활성화 후에 갑자기 화면이 하얗게 되는 경험을 해본 분들이 많을 겁니다. 관리자 패널까지 흰 화면이면 더 당황스럽습니다. 원인과 해결 순서를 알면 대부분 5~10분 안에 복구할 수 있습니다.

WSOD 원인 파악

1. PHP 오류 메시지 확인

wp-config.php에서 일시적으로 디버그 모드를 켭니다.

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

흰 화면 대신 오류 메시지가 표시됩니다. 어떤 파일의 몇 번째 줄에서 오류가 났는지 확인합니다.

2. 서버 오류 로그 확인

sudo tail -50 /var/log/nginx/error.log
sudo tail -50 /var/log/php8.1-fpm.log

PHP Fatal Error나 Out of Memory 오류가 나오면 원인을 특정할 수 있습니다.

플러그인 충돌이 원인일 때

관리자 패널에 접근 가능하다면:

1. 플러그인 → 전체 선택 → 비활성화
2. 사이트 확인
3. 정상이면 플러그인을 하나씩 활성화하면서 원인 찾기

관리자 패널도 흰 화면이면 (FTP/SSH 사용):

# 플러그인 폴더 이름 변경 (전체 비활성화)
mv /var/www/html/wp-content/plugins /var/www/html/wp-content/plugins_disabled

사이트가 복구되면 폴더 이름을 되돌리고 플러그인을 하나씩 활성화합니다.

테마가 원인일 때

# 현재 테마 비활성화 (기본 테마로 임시 변경)
wp theme activate twentytwentythree

또는 FTP에서 현재 테마 폴더 이름을 변경하면 워드프레스가 기본 테마로 자동 전환됩니다.

PHP 메모리 부족이 원인일 때

로그에 “Allowed memory size exhausted” 가 나온다면 메모리 제한을 늘려야 합니다.

// wp-config.php에 추가
define('WP_MEMORY_LIMIT', '256M');

또는 php.ini에서:

memory_limit = 256M

WSOD는 대부분 플러그인 충돌, 테마 오류, 메모리 부족 세 가지 중 하나입니다. 당황하지 말고 순서대로 확인하면 반드시 원인을 찾을 수 있습니다.