PHP 치명적 오류 복구 방법을 알면 사이트 다운 시간을 최소화합니다

워드프레스 PHP 치명적 오류 복구는 플러그인 업데이트 후 “There has been a critical error on this website” 메시지를 마주쳤을 때 필요한 과정입니다. 워드프레스 5.2 이상부터는 치명적 오류 발생 시 관리자 이메일로 복구 링크를 보내는 “복구 모드”가 도입됐습니다. 하지만 이메일을 놓치거나 복구 모드만으로 해결 안 되는 경우도 있어서 FTP/SSH를 통한 방법도 알아두어야 합니다.

워드프레스 복구 모드 활용

치명적 오류 발생 시 워드프레스가 관리자 이메일로 메일을 보냅니다.

제목: [사이트이름] Your site is experiencing a technical issue.
내용: 복구 모드 링크 포함

링크를 클릭하면 문제가 된 플러그인을 비활성화할 수 있는 관리자 페이지가 열립니다. 이메일이 안 왔다면 SMTP 설정이 없어서일 수 있습니다.

수동 복구 — 플러그인 비활성화

복구 모드가 작동하지 않거나 이메일이 없다면 FTP/SSH로 직접 비활성화합니다.

# 최근 업데이트된 플러그인 찾기
ls -lt /var/www/html/wp-content/plugins/ | head -10

# 의심 플러그인 폴더 이름 변경 (비활성화)
mv /var/www/html/wp-content/plugins/problem-plugin \
   /var/www/html/wp-content/plugins/problem-plugin.disabled

폴더 이름이 변경되면 워드프레스가 해당 플러그인을 자동 비활성화합니다.

오류 메시지 확인

어떤 파일에서 오류가 났는지 확인합니다.

# PHP 오류 로그
sudo tail -50 /var/log/php8.1-fpm.log

# 워드프레스 디버그 로그 (WP_DEBUG_LOG = true인 경우)
cat /var/www/html/wp-content/debug.log | tail -30

오류 메시지에서 파일명과 줄 번호를 확인하면 원인 플러그인이나 테마를 특정할 수 있습니다.

플러그인 업데이트 전략 개선

치명적 오류를 예방하려면:

1. 스테이징 환경에서 먼저 테스트: 프로덕션 전에 동일한 환경에서 업데이트 검증
2. 업데이트 전 백업: 매번 백업 후 업데이트
3. 메이저 버전 업데이트 특히 주의: 1.x → 2.x 변경은 신중하게
4. 복수 플러그인 동시 업데이트 금지: 하나씩

치명적 오류는 언제든 올 수 있습니다. 사전에 복구 절차를 한 번 연습해두는 것이 실제 사고 때 당황하지 않는 방법입니다.