이 가이드에서는 카페24 호스팅 환경을 기준으로 PHP Fatal Error의 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. PHP Fatal Error란 무엇인가?
• 2. PHP Fatal Error의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 흰 화면(WSoD) 긴급 해결법
• 5. PHP Fatal Error 예방 방법
• 6. 자주 묻는 질문 (FAQ)

1. PHP Fatal Error란 무엇인가?

PHP Fatal Error는 PHP 스크립트 실행 중 복구할 수 없는 오류가 발생하여 스크립트 실행이 강제로 종료되는 상태입니다. 워드프레스는 PHP로 구동되므로 PHP 치명적 오류가 발생하면
사이트 전체 또는 일부 기능이 완전히 중단됩니다.

주요 증상 유형

2. PHP Fatal Error의 주요 원인 5가지

원인 1 — 플러그인·테마 비호환

가장 흔한 원인입니다. 새로 설치하거나 업데이트한 플러그인/테마가 PHP 버전 또는 기존 다른 플러그인과 충돌하는 경우 Fatal Error가 발생합니다.

원인 2 — PHP 버전 비호환

워드프레스 코어, 플러그인, 테마가 현재 서버의 PHP 버전을 지원하지 않을 때 발생합니다. PHP 5.x, 7.0, 7.2 등 오래된 버전이나, 반대로 플러그인이 아직 지원하지 않는 최신 PHP
버전으로 갑자기 업그레이드할 때 나타날 수 있습니다.

원인 3 — PHP 메모리 부족

PHP 메모리 한도(memory_limit)를 초과하면 “Allowed memory size exhausted” 오류와 함께 Fatal Error가 발생합니다.

원인 4 — 함수 또는 클래스 충돌

두 개 이상의 플러그인이 동일한 함수명이나 클래스명을 사용하면 “Cannot redeclare function” 오류가 발생합니다.

원인 5 — 코드 직접 수정 오류

functions.php나 플러그인 파일을 직접 수정하다 문법 오류(syntax error)가 발생하면 즉시 Fatal Error로 이어집니다.

3. 카페24 호스팅에서 해결 방법

1단계 — 디버그 모드 활성화로 원인 파악

먼저 정확한 오류 메시지를 확인해야 합니다. 카페24 파일 관리자에서 wp-config.php를 편집합니다.

// 오류 디버깅 설정 — wp-config.php에 추가
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);  // 화면에 오류 표시하지 않음

설정 후 /wp-content/debug.log 파일을 확인합니다.

2단계 — 플러그인 전체 비활성화

관리자 화면이 열리지 않으므로 FTP를 사용합니다.

1. 카페24 파일 관리자 또는 FTP로 접속합니다.
2. /wp-content/plugins/ 폴더명을 plugins_disabled로 변경합니다.
3. 사이트에 접속을 시도합니다. 접속되면 플러그인이 원인입니다.
4. 폴더명을 원래대로 복구한 후 플러그인을 하나씩 활성화하며 원인을 찾습니다.

3단계 — 기본 테마로 전환

플러그인 비활성화로 해결되지 않으면 테마가 원인일 수 있습니다.

1. /wp-content/themes/현재테마이름/ 폴더명을 임시로 변경합니다.
2. 워드프레스가 기본 테마(Twenty Twenty-Four)로 자동 전환됩니다.
3. 사이트가 정상화되면 테마가 원인입니다. 테마를 최신 버전으로 업데이트하거나 개발사에 문의합니다.

4단계 — PHP 버전 확인 및 변경

워드프레스 관리자 → [도구] → [사이트 상태]에서 PHP 버전을 확인합니다. PHP 7.4 이하라면 업그레이드가 필요합니다.

카페24에서 PHP 버전 변경 방법:

1. 카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]
2. PHP 버전을 PHP 8.1 또는 8.2로 변경합니다.
3. [저장하기]를 클릭합니다.
4. 버전 변경 후 플러그인·테마 호환성을 반드시 확인합니다.

5단계 — PHP 메모리 한도 증가

wp-config.php에 아래 코드를 추가합니다.

define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '512M');

4. 흰 화면(WSoD) 긴급 해결법

관리자 화면조차 열리지 않는 완전한 흰 화면 상태일 때의 긴급 처치 순서입니다.

1. wp-config.php 수정 (FTP): WP_DEBUG를 true로 설정하고 debug.log에서 오류 확인
2. 플러그인 비활성화 (FTP): plugins 폴더명 변경
3. 테마 전환 (FTP): 현재 테마 폴더명 변경
4. PHP 버전 확인: 카페24 PHP 설정에서 8.1로 변경 시도
5. 메모리 증가: wp-config.php에 WP_MEMORY_LIMIT 512M 추가
6. 백업 복원: 위 방법으로 해결되지 않으면 정상 작동하던 시점의 백업 파일로 복원

카페24에서 백업 복원 방법: 카페24 호스팅 관리자에서 [백업 서비스]를 이용하거나, UpdraftPlus 등 백업 플러그인으로 저장한 외부 백업을 복원하시기
바랍니다.

5. PHP Fatal Error 예방 방법

• 업데이트 전 반드시 백업: 플러그인, 테마, 워드프레스 코어 업데이트 전 전체 백업을 항상 먼저 실행합니다.
• PHP 버전 최신 유지: 카페24 PHP 8.1 이상을 유지하면 보안과 성능이 향상되고 대부분의 최신 플러그인과 호환됩니다.
• 플러그인 호환성 확인: 플러그인 설치 전 WordPress.org에서 PHP 버전 요구사항과 최근 업데이트 날짜를 확인합니다. 1년 이상 업데이트가 없는
  플러그인은 주의가 필요합니다.
• 코드 직접 수정 자제: functions.php나 플러그인 파일 직접 수정은 최소화하고, 수정 전 반드시 백업합니다. 코드 스니펫 추가는 WPCode
  플러그인 활용을 권장드립니다.
• 정기 모니터링: New Relic, UptimeRobot 등으로 사이트 상태를 모니터링하여 문제를 빠르게 감지합니다.

6. 자주 묻는 질문 (FAQ)

Q. 사이트가 완전히 흰 화면(WSoD)으로 나타나요.

흰 화면은 PHP Fatal Error의 대표적인 증상입니다. FTP로 접속하여 plugins 폴더명을 변경해 모든 플러그인을 비활성화하고,
wp-config.php에 WP_DEBUG를 true로 설정하여 debug.log에서 정확한 오류 원인을 파악하세요.

Q. PHP 버전을 올렸더니 플러그인이 작동하지 않아요.

일부 오래된 플러그인은 최신 PHP 버전과 호환되지 않을 수 있습니다. 플러그인을 최신 버전으로 업데이트하거나, 개발이 중단된 플러그인이라면 유사 기능의 최신 대안 플러그인으로 교체하시기
바랍니다.

Q. debug.log 파일에 오류가 너무 많아서 원인을 찾기 어려워요.

debug.log 파일에서 “Fatal error” 또는 “Critical Error” 키워드로 검색하여
치명적인 오류를 먼저 확인합니다. 오류 메시지에 파일 경로가 포함되어 있으므로, 그 경로를 통해 원인 플러그인이나 테마를 파악할 수 있습니다.

Q. 특정 플러그인을 활성화하면 바로 Fatal Error가 나요.

해당 플러그인이 현재 PHP 버전 또는 다른 플러그인과 충돌하는 것입니다. 플러그인을 최신 버전으로 업데이트하고, 그래도 해결되지 않으면 플러그인 개발사에 문의하거나 대안 플러그인을 사용하시기
바랍니다.

정리 — PHP Fatal Error, 이렇게 해결하세요

PHP Fatal Error는 디버그 모드 활성화 → 플러그인 비활성화 → 테마 전환 → PHP 버전 확인 → 메모리 증가 순서로 점검하면 대부분 원인을 찾을 수
있습니다. 무엇보다 정기 백업을 유지하여 복구 옵션을 항상 확보해 두는 것이 중요합니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 503 Service Unavailable 해결
  가이드