WordPress에서 죽음의 흰색 화면 해결: 종합 가이드

게시 됨: 2024-05-16

"WordPress에서 죽음의 흰색 화면"을 경험하는 것은 웹사이트 소유자에게 어려운 문제가 될 수 있습니다. 종종 "WSOD(White Screen of Death)"라고 불리는 이 문제는 사이트에 액세스할 수 없고 공백이 되어 문제 해결에 익숙하지 않은 사람들에게 당황감을 안겨줍니다.

이 종합 가이드에서는 WordPress의 흰색 화면을 진단하고 수정하여 사이트가 빠르게 온라인 상태로 돌아올 수 있도록 하는 단계를 안내합니다.


죽음의 하얀 화면 이해하기

WordPress의 흰색 화면은 일반적으로 웹 사이트의 스크립트가 메모리 제한을 모두 소진할 때 발생합니다. 그러나 다음과 같은 다른 문제로 인해 이 문제가 발생할 수도 있습니다.

  • 플러그인 또는 테마 충돌
  • 소진된 메모리 제한
  • 서버 문제
  • 손상된 코어 파일

이러한 잠재적 원인을 이해하면 문제를 더 잘 진단하고 해결하는 데 도움이 됩니다.


WordPress의 흰색 화면 진단

수정 사항을 살펴보기 전에 흰색 화면의 근본 원인을 진단하는 것이 중요합니다. 따라야 할 몇 가지 초기 단계는 다음과 같습니다.

  1. 모든 페이지 확인 : 흰색 화면이 모든 페이지에 영향을 미치는지 아니면 관리 영역이나 특정 게시물과 같은 사이트의 특정 섹션에만 영향을 미치는지 확인합니다.
  2. 플러그인 및 테마 비활성화 : 모든 플러그인을 비활성화하고 기본 테마(예: Twenty Twenty-One)로 전환하면 특정 플러그인이나 테마가 문제를 일으키는지 식별하는 데 도움이 될 수 있습니다.
  3. 디버깅 모드 활성화 : WordPress에는 문제를 식별하는 데 도움이 되는 오류 메시지를 제공하는 디버깅 기능이 내장되어 있습니다. wp-config.php 파일에 다음 줄을 추가하세요:

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

    그러면 wp-content 디렉터리의 debug.log 파일에 오류가 기록됩니다.

WordPress에서 흰색 화면 수정

잠재적인 원인을 식별한 후에는 특정 문제 해결을 시작할 수 있습니다. 다음은 WordPress의 흰색 화면을 해결하는 몇 가지 세부 단계입니다.

1. 메모리 한도 증가

메모리 소진은 흰색 화면의 일반적인 원인입니다. PHP 메모리 제한을 늘리려면 wp-config.php 파일에 다음 줄을 추가하세요.

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

그래도 문제가 해결되지 않으면 서버의 php.ini 파일이나 .htaccess 파일의 메모리 제한을 늘려야 할 수도 있습니다.

  • php.ini : memory_limit = 128M
  • .htaccess : php_value memory_limit 128M

2. 모든 플러그인 비활성화

플러그인은 종종 흰색 화면 뒤에 있는 범인입니다. 모든 플러그인을 신속하게 비활성화하려면 FTP 또는 호스팅 파일 관리자를 통해 wp-content 폴더의 plugins 디렉터리 이름을 바꾸세요.

  1. wp-content 로 이동합니다.
  2. plugins 폴더의 이름을 plugins_old 로 바꿉니다.

문제가 해결되면 폴더 이름을 다시 plugins 으로 바꾸고 각 플러그인을 하나씩 다시 활성화하여 문제가 있는 플러그인을 식별하세요.

3. 기본 테마로 되돌리기

잘못된 테마로 인해 흰색 화면이 나타날 수도 있습니다. 기본 테마로 전환하려면 wp-content/themes 에서 활성 테마 디렉터리의 이름을 바꾸세요.

  1. wp-content/themes 로 이동합니다.
  2. 활성 테마 폴더의 이름을 바꿉니다(예: mytheme_old ).

WordPress가 설치된 경우 자동으로 기본 테마로 되돌아갑니다. 문제가 해결되면 테마에 오류가 있는지 확인하거나 다른 테마를 사용해 보세요.

4. 디버깅 및 오류 로그 활성화

언급한 대로 wp-config.php 파일에서 디버깅을 활성화하면 흰색 화면의 원인에 대한 통찰력을 얻을 수 있습니다. wp-content 디렉터리에 있는 debug.log 파일에서 오류 메시지를 검토하고 표시된 문제를 해결하세요.

5. 백업 복원

최근 백업이 있는 경우 사이트를 이전 상태로 복원하면 흰색 화면을 빠르게 해결할 수 있습니다. 데이터 손실을 방지하고 복구를 용이하게 하려면 사이트를 정기적으로 백업하십시오.

6. 손상된 코어 파일 확인

손상된 WordPress 코어 파일로 인해 흰색 화면이 나타날 수도 있습니다. 이 문제를 해결하려면 wordpress.org 에서 새로운 WordPress 사본을 다운로드하고 핵심 파일을 교체하세요.

  1. 워드프레스(WordPress)를 다운로드하고 압축을 푼다.
  2. wp-adminwp-includes 폴더를 FTP를 통해 사이트에 업로드하고 기존 폴더를 교체하세요.

이는 테마, 플러그인 또는 업로드에 영향을 미치지 않지만 손상된 핵심 파일을 대체합니다.

7. 구문 오류 수정

최근에 테마나 플러그인에 사용자 정의 코드를 추가한 경우 구문 오류로 인해 흰색 화면이 나타날 수 있습니다. FTP를 통해 파일에 액세스하고 최근 변경 사항에 오류가 있는지 검토하세요. PHP 유효성 검사기를 사용하여 코드에 구문 문제가 있는지 확인하세요.


WordPress에서 흰색 화면 방지

WordPress에서 흰색 화면을 방지하려면 사이트가 원활하게 실행되도록 하기 위한 사전 조치가 필요합니다.

  1. 정기 업데이트 : WordPress, 테마, 플러그인을 최신 버전으로 유지하세요.
  2. 고품질 플러그인 및 테마 : 평판이 좋고 잘 코딩된 플러그인과 테마를 사용하세요.
  3. 정기 백업 : 문제가 발생할 경우 신속하게 복원할 수 있도록 사이트를 정기적으로 백업하세요.
  4. 스테이징 환경 : 업데이트 및 새 플러그인을 라이브 사이트에 적용하기 전에 스테이징 환경에서 테스트하세요.

고급 문제 해결

기본 문제 해결 단계로 흰색 화면이 해결되지 않으면 다음 고급 기술을 고려하십시오.

1. PHP 시간 제한 증가

장기 실행 스크립트로 인해 때때로 흰색 화면이 나타날 수 있습니다. wp-config.php 파일에 다음 줄을 추가하여 최대 실행 시간을 늘립니다.

 set_time_limit(300);

또는 php.ini 파일에서 이 설정을 조정할 수 있습니다:

 max_execution_time = 300

2. 데이터베이스 문제 해결

데이터베이스가 손상되면 흰색 화면이 나타날 수 있습니다. phpMyAdmin을 통해 데이터베이스에 액세스하고 오류를 확인하세요. 문제가 발견되면 "복구" 기능을 사용하십시오.

3. 파일 권한

잘못된 파일 권한으로 인해 흰색 화면이 나타날 수도 있습니다. WordPress 파일 및 디렉터리에 올바른 권한이 있는지 확인하세요.

  • 파일: 644
  • 디렉터리: 755

일반적인 오류 및 해결 방법

다음은 WordPress의 흰색 화면과 관련된 몇 가지 일반적인 오류 및 해결 방법입니다.

1. 메모리 소진 오류

Allowed memory size of x bytes exhausted 와 같은 오류가 표시되는 경우 앞에서 설명한 대로 메모리 제한을 늘리면 문제가 해결됩니다.

2. 500 내부 서버 오류

500 내부 서버 오류가 종종 흰색 화면과 함께 표시됩니다. 자세한 내용은 서버 오류 로그를 확인하고 위에 설명된 문제 해결 단계를 따르세요.

3. 구문 오류

사용자 정의 코드의 구문 오류는 최근 변경 사항을 검토하고 PHP 유효성 검사기를 사용하여 식별하고 해결할 수 있습니다.


결론

WordPress의 흰색 화면은 답답한 문제일 수 있지만, 체계적인 문제 해결을 통해 문제를 해결하고 사이트를 복원하는 것이 가능합니다.

일반적인 원인을 이해하고 이 가이드에서 제공하는 솔루션을 적용하면 흰색 화면을 효과적으로 수정하고 향후 재발을 방지할 수 있습니다.

WordPress 사이트를 건강하게 유지하고 무서운 White Screen of Death를 피하려면 정기적인 유지 관리, 업데이트 및 백업이 중요합니다.