워드프레스(WordPress) 사이트에서 “치명적인 오류가 발생했습니다”라는 메시지가 출력되는 경우,
표면적인 메시지만으로는 원인을 파악하기 어렵습니다.
이 문서는 디버그 로그를 설정하고 오류 원인을 분석하는 절차를 기술 문서 형태로 정리한 것입니다.

1. 디버그 모드 활성화

워드프레스 루트 디렉터리(public_html, www 등)에 위치한 wp-config.php 파일을 열고,
아래의 상수를 추가하거나 수정합니다.

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

설명

• WP_DEBUG : 워드프레스 전역 디버그 모드를 활성화
• WP_DEBUG_LOG : 오류 내용을 /wp-content/debug.log 파일에 기록
• WP_DEBUG_DISPLAY : 오류 메시지를 화면에 출력하지 않도록 설정

저장 후 사이트를 새로 고침하면, 오류 발생 시 자동으로 로그가 생성됩니다.

2. 로그 파일 확인

로그 파일 경로:

/wp-content/debug.log

이 파일을 텍스트 편집기로 열면 아래와 같은 형태로 오류가 기록됩니다.

[31-Oct-2025 08:59:17] PHP Fatal error: Allowed memory size of 268435456 bytes exhausted in /wp-content/plugins/...

주요 키워드

3. 원인 분석

로그에서 오류 발생 경로와 파일명을 확인한 뒤 다음 항목을 점검합니다.

1. 특정 플러그인 또는 테마의 충돌 여부
2. PHP 버전 호환성 문제
3. 메모리 한도(memory_limit) 초과 또는 설정 오류
4. 커스텀 코드의 무한 루프, 비정상 쿼리 등

오류의 원인에 따라 플러그인 비활성화, 설정 수정, 버전 업그레이드 등의 조치를 수행합니다.

4. 디버그 모드 비활성화

문제 해결 후에는 디버그 모드를 비활성화하여 로그 기록을 중단합니다.

define( 'WP_DEBUG', false );

이 설정을 통해 방문자 화면에 오류가 노출되는 것을 방지할 수 있습니다.

5. 결론

“치명적인 오류”는 단순히 워드프레스가 중단된 상태를 의미하며,
정확한 원인은 디버그 로그를 통해서만 확인할 수 있습니다.
위 절차를 통해 오류를 재현하고 로그를 분석하면,
대부분의 플러그인 충돌, 설정 오류, 메모리 초과 문제를 효율적으로 해결할 수 있습니다.