워드프레스에서 Fatal error: Uncaught Error...가 발생하면서 사이트에 접속하지 못하는 문제가 종종 발생할 수 있습니다. 이 오류는 보통 PHP 코드 실행 중 예외가 처리되지 않아 프로그램이 중단되었을 때 발생합니다. 이 에러는 다양한 원인으로 발생할 수 있습니다. 먼저는 오류 로그를 확인하여 문제의 원인을 파악하여 해결을 시도할 수 있습니다.
워드프레스 Fatal error: Uncaught Error… 오류 발생 시 해결 방법
저는 워드프레스 관련 문제를 해결하는 작업을 자주 하는 편입니다. Fatal error: Uncaught Error…는 흔하게 발생하는 오류에 해당하는 것 같습니다.
PHP 호환성 문제
이 오류는 주로 PHP 호환성과 관련되어 나타나는 것으로 보입니다. 예를 들어, PHP 버전이 너무 낮거나, 워드프레스나 테마, 플러그인의 버전이 낮아서 PHP 버전과 호환이 안 될 때 이런 에러가 발생할 수 있습니다.
만약 워드프레스 사이트가 최신 상태가 아니라면 다음과 같은 조치를 취하여 해결을 시도해볼 수 있습니다.
- 사이트 전체 백업을 합니다.
- 워드프레스, 테마, 플러그인을 최신 버전으로 업데이트합니다.
워드프레스에 비해 PHP 버전이 낮은 경우에도 이런 오류가 발생할 수 있습니다. PHP 버전은 도구 » 사이트 건강 » 정보 탭으로 이동하여 서버 섹션에서 확인이 가능합니다.
(2025년 4월 기준으로) 워드프레스에서 권장하는 PHP 버전은 PHP 7.4 이상입니다.
워드프레스의 PHP 호환성에 대한 공식 문서에 의하면 워드프레스 6.7 버전은 PHP 7.1 이하에서는 작동하지 않고 PHP 7.2에서만 사용이 가능합니다.
하지만 일부 플러그인은 PHP 7.3 이하에서는 작동하지 않고 PHP 7.4 이상을 요구할 수 있습니다. 예를 들어, 인기 페이지 빌더인 엘리멘터(Elementor)는 PHP 7.4 이상에서만 작동합니다.
인기 문의폼 플러그인인 Contact Form 7과 인기 테마 중 하나인 GeneratePress 테마도 PHP 7.4 이상에서만 호환이 됩니다.
사이트 속도와 보안을 위해 PHP 버전은 PHP 7.4 이상, 워드프레스 코어, 테마, 플러그인은 가급적 최신 버전으로 업데이트하는 것이 바람직합니다. 워드프레스나 테마, 플러그인이 최신 버전이 아닌 경우 사이트가 해킹되거나 멀웨어(악성코드)에 감염되어 낭패를 볼 수 있습니다.
PHP 버전 업그레이드
PHP 버전이 7.4 이하인 경우에는 PHP 7.4나 PHP 8.0 이상으로 업그레이드하는 것을 고려하시기 바랍니다. (2025년 4월) 현재 최신 PHP 버전은 PHP 8.4이고 카페24는 PHP 8.2 버전까지 지원하고, 이 블로그가 호스팅되고 있는 클라우드우웨이즈는 PHP 8.3까지 지원됩니다.
카페24를 사용하는 경우 PHP 8.2로 버전 변경을 고려해보시기 바랍니다. 다만, 카페24에서 PHP 버전을 변경하면 서버가 변경되기 때문에 사이트의 모든 데이터가 초기화됩니다. PHP 변경을 진행하기 전에 반드시 데이터와 DB를 모두 백업하여 PC로 다운로드해야 합니다.
플러그인 충돌
특정 플러그인이 설치된 워드프레스 버전이나 PHP 버전과 호환이 되지 않아서 Fatal error: Uncaught Error… 오류가 발생할 수 있습니다.
모든 플러그인을 비활성화하여 플러그인 충돌이 오류의 원인인지 여부를 확인할 수 있습니다.모든 플러그인을 비활성화했을 때 문제가 재발하지 않는다면 플러그인 중에 문제를 일으키는 것이 있습니다. 하나씩 플러그인을 활성화하면서 문제를 일으키는 플러그인을 특정할 수 있습니다.
디버그 모드를 활성화하여 오류 로그 확인하기
디버그 모드를 활성화하여 정확한 오류 메시지를 확인한 후에 문제의 원인을 진단하여 해결을 시도해볼 수 있습니다.
PHP 메모리가 부족한 경우
서버의 PHP 메모리 제한 크기가 부족할 경우 "Allowed memory size exhausted" 오류가 나타날 수 있습니다. 특히 엘리멘터와 같은 페이지 빌더 플러그인이나 아바다와 같은 덩치가 큰 테마를 사용하는 경우 메모리 제한 초과 문제가 발생할 수 있습니다.
일반적으로 wp-config.php 파일에 다음과 같은 라인을 추가하여 PHP 메모리 제한 설정값을 높일 수 있습니다.
define('WP_MEMORY_LIMIT', '512M');클라우드웨이즈를 이용하는 경우에는 이 글을 참고하여 WP Memory Limit 크기를 설정할 수 있습니다.
마치며
워드프레스 사이트에서 Fatal error: Uncaught Error… 에러가 발생하는 경우 대처 방법에 대하여 살펴보았습니다. 특히 오랫동안 워드프레스 사이트를 업데이터하지 않고 방치하는 경우에 이런 오류가 발생하는 경우가 있습니다.
상기의 방법을 참고하여 문제 해결을 시도해보시기 바랍니다.
👉 워드프레스나 웹호스팅 관련 문제 해결에 어려움을 겪는 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.
디버그 모드를 활성화하려면 FTP에 접속해야 하나요?
네, 보통 FTP/SFTP에 접속하여 wp-config.php 파일에 코드를 넣어야 합니다.
클라우드웨이즈를 이용한다면 클웨 계정에 로그인하여 에러 로그를 확인할 수도 있을 것입니다.
블루호스트, 패스트코멧, 케미클라우드 등 cPanel을 제공하는 호스팅의 경우 FTP에 접속하면 워드프레스 디버그 모드를 활성화하지 않아도 error.log 파일이 생성되어 있을 수도 있습니다.