"치명적인 오류가 발생했습니다" 디버깅 가이드
-
팁앤테크
- 10-31
- 16,592 회
- 0
워드프레스(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/...주요 키워드
| 구분 | 설명 |
|---|---|
| Fatal error | 실행이 중단되는 심각한 오류 |
| Warning | 경고 수준의 오류 (실행은 가능) |
| Deprecated | 더 이상 사용되지 않는 코드 사용 |
| Notice | 단순 알림 수준의 메시지 |
3. 원인 분석
로그에서 오류 발생 경로와 파일명을 확인한 뒤 다음 항목을 점검합니다.
- 특정 플러그인 또는 테마의 충돌 여부
- PHP 버전 호환성 문제
- 메모리 한도(
memory_limit) 초과 또는 설정 오류 - 커스텀 코드의 무한 루프, 비정상 쿼리 등
오류의 원인에 따라 플러그인 비활성화, 설정 수정, 버전 업그레이드 등의 조치를 수행합니다.
4. 디버그 모드 비활성화
문제 해결 후에는 디버그 모드를 비활성화하여 로그 기록을 중단합니다.
define( 'WP_DEBUG', false );이 설정을 통해 방문자 화면에 오류가 노출되는 것을 방지할 수 있습니다.
5. 결론
“치명적인 오류”는 단순히 워드프레스가 중단된 상태를 의미하며,
정확한 원인은 디버그 로그를 통해서만 확인할 수 있습니다.
위 절차를 통해 오류를 재현하고 로그를 분석하면,
대부분의 플러그인 충돌, 설정 오류, 메모리 초과 문제를 효율적으로 해결할 수 있습니다.