워드프레스 치명적인 오류 PHP Fatal error: Uncaught Error: Undefined class constant 해결 방법

아스트라(Astra) 테마와 엘리멘터 플러그인이 설치된 워드프레스 사이트에서 치명적인 오류가 발생하는 문제 해결을 맡았습니다. 사이트에 접속하니 "이 웹사이트에 치명적인 오류가 있습니다. 워드프레스 장애복구에 관해 더 알아보기" 에러 메시지가 표시되었습니다.

오류 로그를 확인해 보니 PHP Fatal error:  Uncaught Error: Undefined class constant... 오류가 발생하고 있었습니다. 이와 같은 치명적인 오류가 발생할 경우 확인 사항 및 해결 방법에 대하여 간략히 살펴보겠습니다.

워드프레스 치명적인 오류 PHP Fatal error: Uncaught Error: Undefined class constant... 해결 방법

워드프레스에서 치명적인 오류(Fatal error)는 PHP를 기반으로 실행되는 워드프레스 시스템 내에서 코드 실행 도중 복구할 수 없는 심각한 문제가 발생하여 프로그램이 즉시 중단되는 문제입니다. 이 에러가 발생하면 사이트 전체 또는 일부 기능이 멈추며, 경우에 따라 관리자와 방문자 모두 사이트 접속이 불가능해질 수 있습니다.

클라이언트 사이트의 경우 워드프레스를 개발업체에서 관리하고 있었고 클라이언트는 워드프레스 로그인 정보와 FTP 정보를 모른 상태였습니다. 이런 상황에서 침여적인 오류가 발생하면 문제 해결이 불가능할 수도 있습니다. 다행히 클라께서 카페24 호스팅 계정에서 사이트를 운영하고 있어서 FTP에 접속하여 문제의 원인 파악을 시도할 수 있었습니다.

오류 로그(Error Log)를 체크해 보니 다음과 같은 오류가 발생했습니다.

[01-Aug-2025 06:12:43] PHP Fatal error:  Uncaught Error: Undefined class constant 'NOTICE' in /www/wp-content/themes/astra/inc/metabox/class-astra-elementor-editor-settings.php:504
Stack trace:
#0 /www/wp-includes/class-wp-hook.php(307): Astra_Elementor_Editor_Settings->register_document_controls(Object(Elementor\Core\DocumentTypes\Page))
#1 /www/wp-includes/class-wp-hook.php(331): WP_Hook->apply_filters('', Array)
#2 /www/wp-includes/plugin.php(476): WP_Hook->do_action(Array)
#3 /www/wp-content/plugins/elementor/core/base/document.php(612): do_action('elementor/docum...', Object(Elementor\Core\DocumentTypes\Page))
#4 /www/wp-content/plugins/elementor/core/document-types/page-base.php(61): Elementor\Core\Base\Document->register_controls()
#5 /www/wp-content/plugins/elementor/includes/base/controls-stack.php(2282): Elementor\Core\DocumentTypes\PageBase->register_controls()
#6 /www/wp-content/plugins/elementor/includes/base/controls-stack.php(494): Elementor\Contro in /www/wp-content/themes/astra/inc/metabox/class-astra-elementor-editor-settings.php on line 504

이 오류는 아스트라(Astra) 테마의 class-astra-elementor-editor-settings.php 파일에서 정의되지 않은 클래스 상수 NOTICE를 사용하려다 발생한 것입니다. Elementor 또는 Astra 코드 내부에 NOTICE라는 상수가 정의되어 있지 않기 때문에 PHP가 이를 인식하지 못하고 치명적인 에러를 발생시킨 것이며, 이는 주로 테마나 플러그인의 버전 불일치, 또는 사용자 정의 코드의 오타 등으로 인해 발생합니다.

사이트를 살펴보니 아스트라 테마는 최신 버전으로 업데이트되었지만, 엘리멘터를 비롯한 다른 플러그인은 업데이트가 안 되어서 플러그인이 맞지 않아서 발생하는 문제로 추정되었습니다.

플러그인 폴더를 살펴보니 플러그인들이 2022년 3월과 4월에 설치된 이후에 업데이트가 이루어지지 않은 것으로 보였습니다.

반면에 Astra 테마는 엊그제 업데이트가 된 것으로 보였습니다.

아스트라 테마가 최신 버전으로 업데이트되면서 오랫동안 업데이트되지 않은 엘리멘터 플러그인과 충돌이 발생한 것이 원인인 것으로 추정할 수 있습니다.

이 경우 두 가지 방법으로 해결하는 것을 고려할 수 있습니다.

1. 테마 버전을 다운그레이드합니다.
2. 워드프레스, 플러그인을 모두 최신 버전으로 업데이트합니다.

사이트가 2년 이상 업데이트가 안 되었고 워드프레스 버전도 6.0.8로 버전이 낮기 때문에 보안에 문제가 있을 가능성이 높습니다.

오랫동안 업데이트를 하지 않을 경우 보안 취약점이 존재하여 사이트가 해킹을 당하거나 멀웨어(악성코드)에 감염될 우려가 있습니다. 실제로 업데이트를 소홀히 하다 멀웨어에 감염되는 사례가 종종 있습니다.

한동안 업데이트를 하지 않다가 갑자기 최신 버전으로 업데이트하면 사이트 에러가 발생할 가능성이 있습니다. 테스트 사이트를 만들어서 먼저 업데이트 테스트를 한 후에 이상이 없는 것을 발견하거나, 이상이 있더라도 경미하거나 해결이 가능한 것을 확인한 후에 실제 사이트에서 업데이트를 실시할 수도 있습니다.

👉 워드프레스나 웹호스팅 오류로 인해 해결에 어려움을 겪거나 업데이트 테스트 등이 필요한 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.😄

참고

https://avada.tistory.com/3667

카페24 워드프레스 멀웨어 치료 작업

https://avada.tistory.com/3046

해외웹호스팅: 클라우드웨이즈 vs. 블루호스트 vs. 카페24 비교 (Cloudways vs. Bluehost vs. Cafe24)