WordPress WSoD(화이트 스크린 오브 데스)를 수정하는 입증된 방법 9가지

WordPress 사이트를 탐색하다가 갑자기 WSoD( White Screen of Death )를 만나는 것보다 더 나쁜 것은 없습니다. 이 오류로 인해 관리자와 방문자 모두 웹사이트에 액세스할 수 없습니다.

WSoD는 또한 가능한 원인이나 솔루션을 가리키는 정보가 부족하기 때문에 매우 실망스러울 수 있습니다. 그러나 가장 일반적인 WordPress 오류 중 하나이기도 합니다. 따라서 우려되는 동안 대부분의 경우 해결할 수 있습니다.

이 게시물에서는 WordPress WSoD가 무엇이며 일반적인 원인이 무엇인지 설명합니다. 가장 중요한 것은 사이트를 최대한 빨리 백업하고 실행할 수 있는 9가지 잠재적 솔루션을 안내해 드리는 것입니다.

시작하자!

비디오 버전을 보고 싶으십니까?

WordPress의 죽음의 흰색 화면은 무엇입니까?

이름 그대로 WordPress White Screen of Death("WSoD"라고도 함)는 액세스하려는 웹 페이지 대신 빈 흰색 화면이 나타날 때 발생합니다.

사용 중인 브라우저에 따라 다른 오류 메시지가 표시될 수 있습니다. 다음은 "이 페이지는 작동하지 않으며 요청을 처리할 수 없습니다"라는 HTTP 500 오류 경고가 포함된 Chrome의 예입니다.

이제 Mozilla Firefox의 White Screen of Death를 살펴보겠습니다.

보시다시피 그냥 평범한 흰색 화면입니다. 유용한 오류나 경고 메시지가 포함되어 있지 않습니다.

WordPress White Screen of Death는 거의 항상 PHP 코드 오류 또는 메모리 제한 소진으로 인해 발생합니다.

또 다른 가능한 원인은 잘못된 테마 또는 플러그인입니다. 후자는 웹 사이트의 프론트엔드가 다운되었지만 WordPress 관리 영역이 활성화된 경우 문제일 수 있습니다. 사이트의 대시보드가 ​​작동하는지 빠르게 확인하려면 yourdomain.com/wp-admin으로 이동하세요.

그렇다면 WSoD를 어떻게 수정합니까? 물어봐주셔서 기뻐요!

WordPress 죽음의 흰색 화면을 수정하는 방법(9가지 방법)

WordPress White Screen of Death를 경험할 때 우선순위는 가능한 한 빨리 수정하는 것입니다. 이를 염두에 두고 문제를 해결하는 데 사용할 수 있는 9가지 가능한 솔루션을 살펴보겠습니다.

1. WordPress 플러그인 비활성화

WordPress WSoD를 수정하는 가장 쉽고 일반적인 방법 중 하나는 모든 플러그인을 비활성화하는 것입니다. 종종 잘못된 플러그인 업데이트로 인해 사이트가 다운됩니다.

여전히 관리 영역에 액세스할 수 있는 경우 이를 수행하는 빠른 방법은 대시보드에서 플러그인 으로 이동하여 모든 플러그인을 선택한 다음 일괄 작업 드롭다운 메뉴에서 비활성화 를 클릭하는 것입니다.

그러면 모든 플러그인이 비활성화됩니다.

문제가 해결되면 범인을 찾아야 합니다. 이렇게 하려면 플러그인을 하나씩 활성화하고 활성화할 때마다 사이트를 다시 로드하면 됩니다. 프론트엔드가 다운되면 오작동하는 플러그인을 찾은 것입니다.

그런 다음 플러그인 개발자에게 도움을 요청하거나 WordPress 플러그인 디렉토리에 지원 티켓을 게시할 수 있습니다.

WordPress 관리자에 로그인할 수 없는 경우 FTP(파일 전송 프로토콜) 클라이언트를 사용하여 사이트의 파일 디렉토리에 액세스할 수 있습니다.

루트 디렉토리의 wp-content 폴더 아래에서 plugins 폴더를 찾으십시오. "plugins_old" 줄에 따라 이름을 변경합니다.

그런 다음 프런트엔드에서 사이트를 다시 확인합니다. 이것이 작동하면 각 플러그인을 하나씩 테스트해야 합니다. 플러그인 폴더의 이름을 다시 "plugins" 로 변경한 다음, 결함이 있는 폴더를 찾을 때까지 그 안에 있는 각 플러그인 폴더의 이름을 개별적으로 변경합니다.

2. 기본 WordPress 테마로 전환

문제가 플러그인이 아닌 경우 WordPress 테마가 White Screen of Death의 원인일 수 있습니다. 이것이 문제인지 확인하려면 기본 테마로 전환하여 테마를 바꿀 수 있습니다.

관리 영역에 액세스할 수 있는 경우 대시보드에서 모양 > 테마 로 이동합니다. Twenty Twenty와 같은 기본 WordPress 테마를 찾아 활성화합니다.

그런 다음 사이트를 다시 테스트하십시오. 작동한다면 문제가 테마에 있다는 것을 알게 될 것입니다.

대시보드에 액세스할 수 없는 경우 프로세스는 플러그인과 동일합니다.

FTP를 사용하여 사이트 파일에 액세스하고 wp-content/themes 폴더의 이름을 다른 이름으로 바꿉니다.

그런 다음 WordPress는 최신 기본 테마로 되돌아갑니다. 이 테마는 아마도 Twenty Twenty일 것입니다. 다른 테마가 없는 경우 WordPress 테마 디렉토리에서 다운로드한 다음 테마 폴더에 업로드할 수 있습니다.

그런 다음 사이트를 다시 확인하십시오. 작동한다면 테마에 충돌이 있거나 잘못된 업데이트가 있을 수 있습니다. 이 경우 개발자에게 도움을 요청하거나 테마 전환을 고려해야 할 수 있습니다.

3. 브라우저 및 WordPress 플러그인 캐시 지우기

WordPress 사이트의 백엔드에 액세스할 수 있지만 여전히 프론트엔드에 WSoD가 표시되는 경우 캐시 문제 때문일 수 있습니다.

이 문제를 해결하려면 웹 브라우저의 캐시와 WordPress 캐싱 플러그인을 지워보세요(설치되어 있다고 가정).

WordPress 사이트에 WP Rocket 또는 WP Super Cache와 같은 캐싱 플러그인이 설치되어 있는 경우 대부분은 플러그인 설정 페이지를 통해 캐시를 지우는 빠른 방법을 제공합니다.

WP Super Cache를 예로 사용하면 WordPress 대시보드에서 설정 > WP Super Cache > 캐시 삭제 로 이동합니다.

MyKinsta에서 캐시를 지우는 방법

Kinsta 사용자인 경우 MyKinsta를 사용하여 캐시를 지우는 쉬운 방법도 있습니다. 이렇게 하려면 계정에 로그인하십시오. 도구 를 클릭한 다음 사이트 캐시 섹션에서 캐시 지우기 를 클릭합니다.

캐시를 비우면 변경 사항을 저장합니다. 그런 다음 사이트를 다시 방문하여 문제가 해결되었는지 확인합니다. 그렇지 않은 경우 다른 솔루션으로 이동할 때입니다.

4. 디버깅 모드 켜기

WordPress White Screen of Death가 계속 표시되거나 관리 영역이 작동하지 않거나 문제를 발견했다고 생각하지만 더 깊이 파고 싶은 경우 디버깅 모드를 활성화할 수 있습니다. 이것은 귀하의 웹사이트에서 발생하는 모든 오류를 표시합니다.

뉴스레터 신청

트래픽을 1000% 이상 증가시킨 방법을 알고 싶으십니까?

WordPress 내부자 팁이 포함된 주간 뉴스레터를 받는 20,000명 이상의 다른 사람들과 함께하십시오!

지금 구독

디버깅을 활성화하려면 WordPress 설치의 wp-config.php 파일을 열어야 합니다. 그 안에 다음 줄이 있어야 합니다.

 define( 'WP_DEBUG', false );

"false"를 "true"로 변경한 다음 사이트를 다시 로드하십시오. 이 줄이 없으면 파일 맨 위에 추가할 수 있습니다.

흰색 화면 대신 흰색 화면과 몇 가지 오류 메시지가 표시됩니다. 이것은 큰 개선은 아니지만 시작에 불과합니다. WSoD 오류 메시지는 다음과 같이 문제가 발생한 파일을 명시해야 합니다.

 Cannot redeclare get_posts() (previously declared in /var/www/html/wordpress/wp-includes/post.php:1874) in /var/www/html/wordpress/wp-content/plugins/my-test-plugin/my-test-plugin.php on line 38

이 예제 메시지의 끝에서 문제가 my-test-plugin 이라는 플러그인의 38행에 있음을 볼 수 있습니다. 따라서 해당 플러그인을 비활성화하면 문제가 해결됩니다.

디버그 모드를 활성화한 후 오류가 전혀 표시되지 않으면 웹 호스트에 문의해야 할 수 있습니다. 서버에서 디버깅이 올바르게 구성되지 않았을 수 있습니다.

Kinsta 고객은 기본 제공 디버깅 도구를 사용할 수 있습니다. MyKinsta 대시보드에서 웹사이트 이름과 도구 를 차례로 클릭합니다. WordPress 디버깅 아래에서 활성화 를 선택합니다.

그런 다음 MyKinsta 대시보드의 로그 섹션에서 오류 로그에 액세스하고 이를 탐색하여 문제에 대해 자세히 알아볼 수 있습니다.

디버깅 모드를 켜면 웹사이트 정보 중 일부가 승인되지 않은 사용자에게 노출될 수 있습니다. 따라서 사용이 끝나면 항상 모드를 끄십시오.

5. 메모리 제한을 늘리십시오.

위의 해결 방법 중 일부를 시도한 후에도 여전히 두려운 WSoD 빈 페이지가 표시되거나 메모리 제한 또는 소진된 메모리에 대해 불평하는 오류가 발생하면 응용 프로그램에 더 많은 메모리를 할당해야 합니다.

이것은 많은 WordPress 설치에서 wp-config.php 파일을 통해 수행할 수 있습니다. 파일을 열고 다음 코드를 추가합니다.

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

이것이 작동하지 않는 것 같으면 몇 가지 옵션이 있습니다. 일반 환경에서 .htaccess 파일을 사용하여 메모리 제한을 늘릴 수 있습니다. 다음 줄을 추가하기만 하면 됩니다.

 php_value memory_limit 64M

.htaccess 파일에 액세스할 수 없으면 php.ini 파일을 사용하여 대신 메모리 제한을 늘릴 수 있습니다.

그렇게 하려면 FTP를 통해 서버에 연결하십시오. 사이트의 루트 디렉토리에서 php.ini 파일을 찾으십시오. 파일을 찾으면 파일 내부의 아무 곳에나 다음 줄을 추가합니다.

 memory_limit = 64M

여전히 메모리가 부족하여 더 할당해야 하는 경우 애플리케이션에 문제가 있을 수 있습니다. 아마도 테마 또는 플러그인 중 하나가 과도한 양의 리소스를 사용하고 있을 수 있습니다.

이 시점에서 개발자를 고용하여 살펴볼 수 있습니다. 호스트도 사이트에 대한 SQL 로그 및 기타 리소스 통계를 표시하여 도움을 줄 수 있습니다.

6. 파일 권한 문제 확인

WSoD의 또 다른 잠재적 원인은 권한 및 소유권 문제입니다. 이 문제 는 스스로 해결할 수 있습니다. 그러나 자신이 무엇을 하고 있는지 정확히 알지 못하는 경우 공격자가 악용할 수 있는 취약점을 무심코 만들 수 있으므로 사용하지 않는 것이 좋습니다.

WordPress 권한과 관련하여 따라야 할 세 가지 간단한 규칙이 있습니다.

• 파일은 664 또는 644로 설정해야 합니다.
• 폴더는 775 또는 755로 설정해야 합니다.
• wp-config.php 파일은 660, 600 또는 644로 설정해야 합니다.

서버에 대한 SSH 액세스 권한이 있는 경우 루트 WordPress 디렉터리에서 다음 명령을 실행하여 적절한 규칙을 적용할 수 있습니다.

 sudo find . -type f -exec chmod 664 {} + sudo find . -type d -exec chmod 775 {} + sudo chmod 660 wp-config.php

이 작업을 수행하는 방법이 확실하지 않거나 약간 겁이 있는 경우 웹 호스트에게 도움을 요청하십시오.

7. 자동 업데이트 실패 문제 확인

때로는 WordPress에서 서버 시간 초과와 같은 업데이트 문제가 발생합니다. 종종 이 문제는 자동으로 해결됩니다. 그러나 드문 경우지만 WordPress White Screen of Death로 이어질 수 있습니다.

가장 먼저 해야 할 일은 WordPress 루트 디렉토리로 이동하여 .maintenance 파일이 있는지 확인하는 것입니다(파일 이름도 축약형일 수 있음).

원하는 것은 해당 파일을 삭제하고 사이트를 다시 로드하는 것입니다.

업데이트에 성공했지만 WordPress가 이 파일을 자동으로 제거하지 못하면 모든 것이 정상으로 돌아갑니다.

업데이트가 완료되지 않은 경우 자동으로 다시 시작될 수 있으며, 이 경우 모든 것이 동일하게 정상으로 돌아갑니다.

다른 모든 방법이 실패하면 WordPress에 대한 권장 수동 업데이트 절차를 따르십시오. 그러면 문제가 완전히 해결됩니다.

8. 구문 오류 해결 또는 백업 복원

WordPress WSoD의 또 다른 일반적인 원인은 WordPress 사이트에서 코드를 편집하고 실수로 무언가를 잘못 입력하거나 잘못된 구문을 사용하는 경우입니다.

잘못된 위치에 있는 한 문자가 전체 사이트를 중단시킬 수 있으므로 라이브 프로덕션 사이트에서 코드를 편집하면 안 됩니다.

하지만 걱정하지 마세요. FTP를 통해 언제든지 사이트에 연결하고 수동으로 변경한 사항을 되돌릴 수 있습니다. 어떤 변경 사항이 문제를 일으켰는지 모르는 경우 WordPress 백업을 준비하는 것이 편리합니다.

여기 Kinsta에서 클릭 한 번으로 사이트를 이전 시점으로 복원할 수 있습니다. 이렇게 하려면 MyKinsta 대시보드에 로그인하고 백업 으로 이동합니다.

이전에 WordPress에서 디버그 모드를 활성화한 경우 구문 분석 오류를 나타내는 오류 메시지가 나타날 수도 있습니다. 이 경우 문제 코드를 찾을 위치를 정확히 알려주어야 합니다.

9. PHP 텍스트 처리 능력 향상

이 시점에서 WSoD가 아직 해결되지 않은 경우 시도할 수 있는 한 가지 추가 트릭이 있습니다. 드문 경우지만 이 문제는 페이지나 게시물이 특히 길기 때문에 발생할 수 있습니다.

이 경우 역추적 및 재귀 제한을 늘려 사이트에서 PHP 텍스트 처리 기능을 조정할 수 있습니다. 이렇게 하려면 wp-config.php 파일에 다음 코드를 붙여넣습니다.

 /* Trick for long posts / ini_set('pcre.recursion_limit',20000000); ini_set('pcre.backtrack_limit',10000000);

이 코드를 추가한 후 변경 사항을 저장하십시오. 그런 다음 사이트를 새로고침하여 지금 작동하는지 확인하세요.

요약

WordPress White Screen of Death는 믿을 수 없을 정도로 실망스럽고 두렵기까지 합니다. 잘못될 수 있는 일들이 많이 있지만 고맙게도 상황은 일반적으로 보이는 것만큼 나쁘지 않습니다.

대부분의 경우 간단한 플러그인 및/또는 테마 확인으로 WSoD 문제를 해결할 수 있습니다. WordPress 디버그 모드에 더 익숙해지면 확실히 문제에 대해 더 많은 정보를 얻을 수 있고 안내할 것입니다.

다른 WordPress White Screen of Death 상황이 발생하면 이를 통해 배우고 경험을 공유할 수 있도록 알려주십시오!