---

워드프레스 사이트를 운영하다 보면 플러그인이나 테마 업데이트 후 갑작스레 사이트가 다운되는 상황을 겪을 수 있습니다. 이런 위기에서 큰 도움이 되는 기능이 바로 WordPress 복구 모드(Recovery Mode)입니다. WordPress 5.2 버전부터 도입된 이 기능은 치명적인 오류 발생 시에도 관리자 패널에 접근해 문제를 해결할 수 있게 해줍니다.

이 글에서는 복구 모드의 개념부터 활성화 방법, 사용법, 그리고 효과적인 문제 해결 팁까지 자세히 다룹니다.

목차

1. 복구 모드란?
2. 복구 모드 활성화 방법
3. 복구 모드 사용하기
4. 자주 발생하는 문제와 해결 방법
5. 복구 모드 관련 팁과 모범 사례
6. 결론

복구 모드란?

WordPress 복구 모드는 사이트에 치명적인 PHP 오류가 발생했을 때 관리자가 접근할 수 있도록 제공되는 안전망입니다. 플러그인, 테마, 또는 사용자 정의 코드로 인해 오류가 발생하면 사이트와 관리자 패널이 모두 먹통이 될 수 있습니다. 복구 모드는 이런 상황에서 문제를 일으킨 요소를 비활성화하거나 수정할 수 있게 도와줍니다.

복구 모드의 주요 특징

• 문제 요소 감지: 오류를 유발한 플러그인이나 테마를 자동으로 식별합니다.
• 일시적 비활성화: 문제 요소를 임시로 비활성화해 사이트를 복구합니다.
• 관리자 접근 보장: 오류 상태에서도 관리자 패널에 접속 가능합니다.
• 오류 정보 제공: 오류 원인과 관련 파일 정보를 알려줍니다.

복구 모드 활성화 방법

복구 모드는 여러 방식으로 활성화할 수 있으며, 아래는 주요 방법들입니다.

1. 자동 이메일 링크 활용

치명적인 오류 발생 시 WordPress는 관리자 이메일로 알림을 보내고, 복구 모드 진입 링크를 제공합니다.

1. 관리자 이메일에서 ‘사이트에 문제가 발생했습니다’라는 제목의 메일을 확인합니다.
2. 메일 내 ‘관리자 페이지로 이동’ 또는 ‘Enter Recovery Mode’ 링크를 클릭합니다.
3. 링크에 포함된 복구 키로 관리자 패널에 로그인되며 복구 모드가 활성화됩니다.

참고: 이 링크는 24시간 동안 유효하며, 이후에는 새 링크가 필요합니다.

2. wp-config.php 파일 수정

이메일 접근이 어렵거나 메일이 오지 않을 경우, wp-config.php 파일을 편집해 수동으로 활성화할 수 있습니다.

1. FTP, SFTP 또는 호스팅 파일 관리자로 WordPress 루트 디렉토리에 접근합니다.
2. wp-config.php 파일을 열어 편집합니다.
3. <?php 바로 아래에 다음 코드를 추가합니다:

   define( 'WP_RECOVERY_MODE_COOKIE', '1' );

4. 파일을 저장하고 사이트에 접속하면 복구 모드가 실행됩니다.
5. 문제 해결 후 해당 코드를 삭제합니다.

3. 브라우저 쿠키 설정

개발자 도구를 활용해 복구 모드를 수동으로 켤 수도 있습니다.

1. WordPress 사이트에 접속합니다.
2. 브라우저 개발자 도구(Chrome: F12 또는 Ctrl+Shift+I)를 엽니다.
3. 콘솔 탭에서 아래 코드를 입력합니다:

   document.cookie = "wordpress_recovery_mode=1; path=/; domain=yourdomain.com";

(yourdomain.com은 실제 도메인으로 변경)

4. 페이지를 새로고침하면 복구 모드가 활성화됩니다.

복구 모드 사용하기

복구 모드에 진입하면 다음 단계를 통해 문제를 해결할 수 있습니다.

1. 문제 원인 파악

복구 모드 진입 시 WordPress는 오류를 일으킨 플러그인이나 테마를 알려줍니다. 관리자 대시보드 상단에 다음과 같은 메시지가 표시됩니다:

“현재 복구 모드 상태입니다. [플러그인/테마 이름]에서 치명적인 오류가 발생했습니다.”

2. 플러그인 비활성화

플러그인이 원인일 경우:

1. ‘플러그인’ 메뉴로 이동합니다.
2. 문제 플러그인을 찾아 ‘비활성화’를 클릭합니다.

3. 테마 변경

테마가 원인일 경우:

1. ‘외모 > 테마’로 이동합니다.
2. 기본 테마(Twenty Twenty-Three 등)를 활성화합니다.

4. 사이트 점검

문제 요소를 비활성화한 후:

1. 사이트 프론트엔드를 확인해 정상 작동 여부를 점검합니다.
2. 복구 모드를 종료하려면 로그아웃 후 재로그인합니다.

5. 개발자 보고

문제를 확인했다면 개발자에게 피드백을 제공하세요:

1. 오류 메시지와 발생 상황을 기록합니다.
2. WordPress 버전, PHP 버전, 기타 플러그인 정보를 포함합니다.
3. 지원 포럼이나 이메일로 보고합니다.

자주 발생하는 문제와 해결 방법

복구 모드 이메일 미수신

1. 스팸 폴더를 확인합니다.
2. 관리자 이메일 설정이 맞는지 점검합니다.
3. 서버 메일 기능이 작동하는지 확인합니다.
4. wp-config.php 수동 활성화 방법을 사용합니다.

원인 파악 실패

1. 최근 변경 사항(플러그인 설치, 테마 변경 등)을 검토합니다.
2. 오류 로그(wp-content/debug.log)를 확인합니다.
3. 디버그 모드를 활성화합니다:

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

4. 플러그인을 순차적으로 비활성화하며 테스트합니다.

복구 모드 미작동

1. FTP로 문제 플러그인/테마 폴더 이름을 변경합니다(예: problem-plugin → problem-plugin-disabled).
2. 데이터베이스에서 플러그인을 비활성화합니다:

   UPDATE wp_options SET option_value = 'a:0:{}' WHERE option_name = 'active_plugins';

(테이블 접두어는 환경에 맞게 조정)

복구 모드 관련 팁과 모범 사례

1. 정기 백업

• 파일과 데이터베이스를 포함한 전체 백업을 주기적으로 생성합니다.
• UpdraftPlus 같은 도구나 호스팅 백업 서비스를 활용합니다.

2. 스테이징 환경

• 변경 사항을 실 사이트에 적용하기 전 스테이징에서 테스트합니다.
• 호스팅 제공업체의 스테이징 기능을 사용하세요.

3. 디버그 모드

• wp-config.php에 디버그 설정을 추가해 오류를 추적합니다:

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

4. 보안 강화

• 복구 모드 링크를 즉시 사용하고 세션을 종료합니다.
• 이메일 계정 보안을 강화하세요(2단계 인증 등).

5. 신뢰할 수 있는 플러그인

• WordPress.org에서 검증된 플러그인을 사용합니다.
• 최근 업데이트되고 평점이 높은 플러그인을 선택하세요.

결론

WordPress 복구 모드는 사이트 오류 발생 시 신속히 대응할 수 있는 강력한 도구입니다. 이를 활용하면 다운타임을 줄이고 사용자 경험을 개선할 수 있습니다. 복구 모드 사용법을 익히고, 백업, 스테이징, 디버깅 같은 모범 사례를 실천하면 위기 상황에서도 침착하게 대처할 수 있습니다.