워드프레스 사이트를 운영하다 보면, 갑자기 화면에 아무 내용 없이 하얀 화면만 표시되는 오류를 만날 때가 있습니다. 이른바 '죽음의 흰색 화면(White Screen of Death, WSoD)' 오류인데요. 이 문제는 다양한 원인으로 인해 발생할 수 있습니다. 워드프레스에서 화면에 아무런 콘텐츠가 표시되지 않고 흰색만 나타난다면, 이 글에서 제시하는 방법을 참고하여 원인을 파악하고 해결을 시도해 보시기 바랍니다.
워드프레스에서 죽음의 흰색 화면(White Screen of Death, WSoD) 오류를 해결하는 방법
워드프레스는 5.2 업데이트 이후 소위 '죽음의 흰색 화면'이 나타나는 오류가 줄었지만 종종 이 문제를 호소하는 사용자들이 계십니다.
이 문제는 여러 가지 원인으로 인해 발생하며, 먼저 원인을 파악해야 오류를 해결할 수 있습니다. 개인적인 경험상 PHP 메모리 제한 크기(Memory Limit)가 작은 경우에 이 오류가 종종 발생하는 것을 경험했습니다. 또한, 플러그인 충돌로 인해서도 이 오류가 나타날 수 있습니다.
PHP 메모리 제한(PHP Memory Limit) 크기 늘리기
메모리가 부족할 경우 흰색 화면 오류가 발생할 수 있습니다. wp-config.php 파일에 아래 코드를 추가하여 메모리 한도(Memory Limit) 크기를 늘릴 수 있습니다.
define('WP_MEMORY_LIMIT', '512M');특히 엘리멘터 등 덩치가 큰 플러그인이나 아바다 등 많은 서버 리소스를 요구하는 테마를 사용하는 경우 메모리 크기가 작으면 다양한 오류가 발생할 수 있습니다.
PHP 메모리 제한 크기를 늘리는 방법은 이용하는 웹호스팅에 따라 다를 수 있습니다. 위의 방법으로 메모리 크기가 증가하지 않을 경우 웹호스팅 업체에 문의하여 PHP Memory Limit 설정값을 변경하는 방법에 대하여 문의해보시기 바랍니다.
클라우드웨이즈(Cloudways)를 이용하는 경우 다음 글을 참고하여 PHP 메모리 제한 크기를 늘릴 수 있습니다.
케미클라우드나 패스트코멧을 사용하는 경우 다음 글을 참고해 보세요.
가비아 호스팅을 이용하는 경우에는 PHP 메모리 설정값이 256M로 고정되어 있고 이 값을 변경하지 못할 수 있습니다.
플러그인 충돌 문제
플러그인 충돌도 이 오류의 주요 원인 중 하나입니다. 다음 방법으로 모든 플러그인을 비활성화하여 문제가 해결되는지 체크해 보세요.
- 워드프레스 관리자 페이지에 접속이 가능하다면, 플러그인 » 설치한 플러그인에서 모든 플러그인을 비활성화합니다.
- 관리자 페이지에 접속할 수 없다면, FTP나 파일 관리자를 통해 서버에 접속하여 wp-content/plugins 폴더의 이름을 wp-content/plugins-old 등으로 변경하면 모든 플러그인이 일괄적으로 비활성화됩니다.
흰색 화면만 표시되어도 워드프레스 알림판에 접속이 가능한 경우가 많지만, 만약 관리자 페이지에 접속할 수 없고 FTP/SFTP에도 접속할 수 없다면 문제의 원인을 찾는 것이 불가능할 수 있습니다.
디버그 모드를 활성화하여 오류 로그 확인하기
문제 해결의 첫 단계로 오류 로그를 확인하는 것이 좋습니다. 운이 좋으면 에러 로그에 문제의 원인을 추정할 수 있는 오류 메시지가 있을 수 있습니다. 워드프레스에서 디버그 모드를 활성화하여 오류 로그를 체크하는 방법은 다음 글을 참고해 보세요.
표시되는 오류 메시지를 검토하여 적절한 조치를 취할 수 있습니다. 단서가 될 만한 오류 메시지가 없는 경우에는 원인을 찾는 것이 쉽지 않을 수 있습니다.
테마 문제
많은 문제가 플러그인 충돌 때문이지만, 경우에 따라서는 테마 때문에 이 오류가 발생할 수도 있습니다.
- 관리자 페이지에 접속이 가능하면 모양 » 테마로 이동하여 테마를 워드프레스 기본 테마(예: Twenty Twenty-Five)로 변경합니다.
- 관리자 페이지에 접속이 불가능한 경우에는 FTP나 파일 관리자를 통해 wp-content/themes폴더로 이동하여 현재 활성화된 테마 폴더의 이름을 임시로 변경하면 워드프레스가 자동으로 기본 테마로 전환됩니다.
테마를 변경한 후에 사이트가 정상적으로 보이면 테마에 문제가 있는 것입니다. 유료 테마인 경우에는 테마 판매자에게 연락하여 지원을 요청할 수 있습니다.
캐시 및 브라우저 캐시 삭제
워드프레스 캐싱 플러그인을 사용하고 있다면 캐시 플러그인의 캐시를 완전히 삭제하고, 브라우저 캐시도 지운 뒤 사이트를 새로 고침하여 문제가 해결되는지 체크해 보세요.
클라우드웨이즈를 이용한다면 서버 레벨에서 캐시를 완전히 삭제하여 문제가 해결되는지 확인해 보시기 바랍니다.
파일 권한 확인
파일 권한(퍼미션)이 잘못 설정된 경우에도 흰색 화면 오류가 나타날 수 있습니다. 일반적으로 워드프레스에서 파일은 644, 폴더는 755 권한이 적절합니다.
특히 AWS나 Vultr에서 직접 서버를 생성하여 운영하는 경우에 서버 세팅 문제로 인해 이 오류가 발생할 수 있습니다. 서버 지식이 제한적인 경우에는 클라우드웨이즈와 같은 호스팅을 이용하는 것을 고려할 수 있습니다. 저는 클라우드웨이즈에서 Vultr 서버를 생성하여 이용하고 있습니다.😄
최신 버전으로 업데이트
경우에 따라 워드프레스, 테마, 플러그인을 최신 버전으로 업데이트하면 문제가 해결되곤 합니다. 먼저 백업을 확실히 한 후에 사이트를 최신 버전으로 업데이트해 보시기 바랍니다.
PHP 버전이 낮은 경우나, 오랫동안 업데이트가 안 된 사이트의 경우 업데이트하는 것이 쉽지 않을 수 있습니다.
👉 중요한 사이트이거나 오랫동안 업데이트가 안 된 사이트의 경우 테스트 사이트를 만들어서 업데이트 테스트를 실시하는 것을 고려할 수 있습니다. 테스트 서버에 임시 사이트를 생성하여 테스트 작업을 할 수 있습니다. 이 작업을 직접 수행하기 어려운 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.
복원하기
상기의 방법으로 해결이 되지 않는 경우, 백업본이 있다면 백업본을 이용하여 사이트를 복원하는 것도 고려할 수 있습니다.
- 카페24를 이용하는 경우 지난 7일 이내의 기간으로 복원이 가능하고
- 클라우드웨이즈는 백업 설정에 따라 최대 4주 이내의 기간으로 복원이 가능합니다.
- 케미클라우드는 이용하는 호스팅 상품에 따라 10일 ~ 30일 이내의 기간으로 사이트를 복구할 수 있습니다.
다만, 이 방법을 이용하여 사이트를 복원할 경우 백업본 날짜 이후의 업데이트는 모두 사라지게 됩니다.
호스팅 업체 문의
모든 조치에도 불구하고 문제 해결이 안 되는 경우 웹호스팅 업체에 연락하여 도움을 요청할 수 있습니다. 보통 워드프레스 문제는 웹호스팅 업체에서 해결해주지 않지만, 친절한 담당자를 만나면 문제를 해결해 줄 수도 있을 것입니다.
마치며
이상으로 워드프레스에서 아무런 내용 없이 흰색 화면이 나타나는 오류가 발생하는 경우 해결 방법에 대하여 살펴보았습니다.
| 원인 | 해결 방법 요약 |
|---|---|
| 플러그인 충돌 | 모든 플러그인을 비활성화한 후 문제가 해결되는지 체크 |
| 테마 문제 | 기본 테마로 변경하여 정상화되는지 확인 |
| PHP 메모리 부족 | wp-config.php에 메모리 제한 설정값을 높이는 코드 추가 |
| 캐시 문제 | 캐시 플러그인 및 브라우저 캐시 삭제 |
| 핵심 파일/권한/손상 | 파일 교체, 권한(퍼미션) 점검 |
| 기타 (복원/웹호스팅) | 백업 복원, 웹호스팅 업체에 문의 |
👉 이 글에서 다루는 워드프레스 오류뿐만 아니라 워드프레스 또는 웹호스팅 문제로 인해 해결에 어려움을 겪는 경우 여기에서 서비스(유료)를 요청할 수 있습니다.
댓글 남기기