WordPress 백색 화면 오류

이 오류의 의미와 확인 방법

• WordPress 사이트의 프런트엔드, 관리 대시보드 또는 둘 다 오류 메시지 없이 완전히 빈 흰색 페이지로 표시됩니다.
• 사이트 전체에 문제가 발생하거나 특정 대시보드 화면, 템플릿, 쇼트코드, 블록 또는 URL에만 영향을 줄 수 있습니다.
• 플러그인이나 테마를 설치하거나 업데이트한 직후 빈 페이지가 나타날 수 있습니다.
• 호스팅 업체가 사이트의 PHP 버전을 변경한 후 문제가 시작될 수 있습니다.
• PHP 오류를 일으킨 플러그인, 테마, 메모리 문제, 호환성 문제 또는 손상된 파일을 해결할 때까지 영향을 받은 요청은 계속 빈 화면으로 표시됩니다.

가능성이 높은 순서의 주요 원인

1. 플러그인의 PHP 치명적 오류 — 플러그인을 설치하거나 업데이트한 후 문제가 시작되었거나 플러그인과 관련된 페이지만 작동하지 않을 때 가장 가능성이 높은 원인입니다.
2. 활성 테마 오류 — 테마 또는 테마의 functions.php에 문제가 있으면 여러 페이지나 사이트 전체에 영향을 줄 수 있습니다.
3. PHP 메모리 고갈 — 요청이 구성된 memory_limit를 초과할 수 있으며, 로그에는 일반적으로 Allowed memory size exhausted가 표시됩니다.
4. PHP 버전 비호환성 — 플러그인이나 테마에 현재 호스팅 업체가 사용하는 PHP 버전에서 작동하지 않는 코드가 포함되어 있을 수 있습니다.
5. 손상된 WordPress 코어 파일 — 업데이트가 중단되었거나 완전히 완료되지 않으면 코어 파일이 손상될 수 있습니다. 다만 플러그인이나 테마를 변경한 직후 문제가 명확히 발생했다면 가능성은 낮습니다.

해결 방법

1. 사이트를 보호하고 실패한 요청 확인

호스팅 도구에서 백업을 제공한다면 파일을 수정하기 전에 백업을 생성하세요. 빈 페이지가 프런트엔드, 대시보드 또는 특정 URL에만 영향을 주는지 기록하세요. SFTP 또는 호스팅 패널의 파일 관리자에 접근할 수 있어야 하며 wp-config.php를 수정할 권한도 필요합니다.

2. 방문자에게 오류를 노출하지 않고 디버그 로깅 활성화

wp-config.php를 열고 다음 설정을 추가하거나 업데이트하세요. 각 상수는 한 번만 정의되어야 합니다.

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

운영 중인 사이트에서는 WP_DEBUG_DISPLAY를 false로 유지하세요. 백색 화면이 표시되는 정확한 URL을 다시 로드한 다음 wp-content/debug.log를 확인하세요. 치명적 오류, 파일 경로 및 줄 번호를 찾습니다. WordPress 로그가 생성되지 않거나 해당 이벤트가 포함되어 있지 않다면 호스팅 업체에 계정의 PHP 오류 로그를 확인해 달라고 요청하세요.

3. 로그에서 확인된 플러그인 비활성화

오류에 플러그인 이름이 표시되면 SFTP 또는 호스팅 파일 관리자를 사용해 wp-content/plugins/를 여세요. 해당 플러그인 폴더 이름 뒤에 -disabled와 같은 접미사를 추가해 이름을 변경하세요. 이름을 변경하면 파일과 설정은 보존하면서 WordPress가 플러그인을 로드하지 않게 할 수 있습니다.

오류가 발생한 URL을 다시 로드하세요. 정상적으로 작동한다면 해당 플러그인이 직접적인 원인입니다. 사이트의 WordPress 및 PHP 버전과 호환되는 업데이트가 있는지 확인하고, 적절한 업데이트가 없다면 플러그인 개발자에게 문의하세요. 폴더 이름을 변경해 사이트가 복구되었다는 이유만으로 호환되지 않거나 오래된 플러그인을 다시 활성화하지 마세요.

4. 활성 테마 테스트

로그에서 활성 테마를 가리키거나 확인된 플러그인을 비활성화해도 문제가 해결되지 않으면 wp-content/themes/에서 해당 테마 폴더의 이름을 변경하세요. WordPress는 사용 가능한 기본 테마로 대체되어 실행되어야 합니다.

사이트가 복구되면 로그에 표시된 파일과 줄을 확인하고, 특히 functions.php를 주의 깊게 살펴보세요. 사용할 수 있는 대체 테마가 설치되어 있지 않다면 테스트 후 원래 폴더 이름으로 복원하고, 추가 변경을 하기 전에 테마 제공업체나 호스팅 업체에 문의하세요.

5. 메모리 고갈 오류 해결

로그에 Allowed memory size exhausted가 표시되면 실패한 요청이 구성된 PHP 메모리 제한을 초과한 것입니다. 사이트의 호스팅 또는 WordPress 관리 절차에 따라 제한을 안전하게 늘리고, 플러그인, 테마 또는 특정 요청이 과도한 메모리를 사용하는지 조사하세요.

승인된 설정을 변경한 후 같은 URL을 다시 로드하고 동일한 치명적 오류가 더 이상 기록되지 않는지 확인하세요. 제한을 늘리는 것만으로는 비효율적이거나 호환되지 않는 구성 요소의 문제를 가릴 수 있으므로 오류가 다시 발생하면 계속 조사해야 합니다.

6. PHP 버전 호환성 확인

PHP 버전을 변경한 후 백색 화면이 시작되었다면 로그에 표시된 플러그인이나 테마와 변경 시점이 일치하는지 비교하세요. 해당 확장 기능을 일시적으로 비활성화하면 관련성을 확인하는 데 도움이 될 수 있습니다.

플러그인이나 테마를 업데이트, 교체 또는 수정하는 동안 일시적으로 PHP 버전을 되돌릴 수 있는지 호스팅 업체에 문의하세요. 버전 롤백은 진단 또는 임시 조치로만 사용해야 하며, 영구적인 호환성 해결책으로 간주해서는 안 됩니다.

7. 근거가 있을 때만 코어 파일 복원

플러그인, 테마, PHP 또는 메모리 변경으로 문제가 설명되지 않고 로그에서도 확장 기능이 확인되지 않는다면 WordPress 코어 파일이 손상되었을 가능성이 있습니다. 공식 WordPress 최신 다운로드 파일에서 일치하는 코어 파일을 받아 SFTP로 다시 업로드하세요.

wp-content 또는 wp-config.php를 덮어쓰지 마세요. 코어 파일과 사이트 콘텐츠 및 설정 파일을 확실하게 구분할 수 없다면 작업을 중단하고 호스팅 업체나 WordPress 전문가에게 도움을 요청하세요.

8. 복구 확인 및 정리

빈 화면이 표시되었던 정확한 프런트엔드 URL 또는 관리 화면을 다시 로드하세요. 동일한 플러그인, 테마, 쇼트코드 또는 블록을 사용하는 관련 페이지도 테스트하세요. wp-content/debug.log를 검토하여 동일한 치명적 오류가 반복되지 않는지 확인하세요.

원인이 확인되면 임시 디버깅 설정을 비활성화하거나, 계속 유지하는 로그가 외부에 공개되지 않도록 보호하세요.

예방 및 해결 확인 방법

• WordPress, 플러그인, 테마 또는 호스팅 PHP 버전을 업데이트하기 전에 사이트를 백업하세요.
• 문제와 관련된 변경 사항을 식별할 수 있도록 플러그인과 테마를 한 번에 하나씩 업데이트하세요.
• 주요 WordPress, PHP, 테마 및 플러그인 변경 사항은 운영 환경에 적용하기 전에 스테이징 사본에서 테스트하세요.
• 운영 사이트에서는 WP_DEBUG_DISPLAY를 비활성화하고 모든 디버그 로그에 대한 접근을 제한하세요.
• 사용 가능한 PHP 메모리를 모니터링하고 구성된 제한에 반복적으로 근접하는 구성 요소를 조사하세요.
• 수정할 때마다 정확히 오류가 발생한 URL을 다시 로드하고 동일한 치명적 오류가 재발했는지 로그를 검토하세요.

자주 묻는 질문