워드프레스 빈 화면 오류, 플러그인·테마 충돌 FTP 복구법
플러그인 업데이트 버튼을 눌렀거나 테마 설정 파일을 조금 수정한 직후, 블로그 화면이 아무 글자도 없는 새하얀 백지로 변하거나 “이 웹사이트에 치명적인 오류가 있습니다”라는 문구만 뜨고 아예 열리지 않을 때가 있습니다. 엎친 데 덮친 격으로 관리자 페이지(‘/wp-admin’)마저 똑같이 막혀 버리면 문제의 플러그인을 끌 방법조차 막막해집니다.
가게 내부 전기 배선에서 합선이 일어나 정문 자동문과 내부 조명 스위치(관리자 페이지)가 한꺼번에 잠겨 버렸을 때, 정문 앞에서 키를 눌러 보아야 소용없고 건물 뒤편 관리실 비상 통로(FTP 서버 접근)로 들어가 합선된 차단기만 내리는 상황과 같습니다. 실제 서버에서도 워드프레스 빈 화면 오류는 데이터베이스 손상보다 PHP 실행 충돌인 경우가 대부분이므로 FTP나 SFTP로 파일 경로만 조정하면 비교적 빠르게 살려낼 수 있습니다.
관리자 페이지까지 막히는 워드프레스 빈 화면 오류 발생 원리
웹사이트에 접속했을 때 아무것도 출력되지 않는 백지 상태를 흔히 죽음의 백지 화면(WSOD, White Screen of Death) 이라고 부르며, 워드프레스 5.2 이상 버전에서는 보안상 상세 에러를 감춘 채 “이 웹사이트에 치명적인 오류가 있습니다(There has been a critical error on this website)”라는 안내 화면을 띄웁니다.
워드프레스는 방문자가 주소를 요청하는 순간 PHP 엔진이 코어 파일, 활성화된 모든 플러그인, 그리고 현재 테마의 ‘functions.php’ 파일을 순서대로 읽어 들인 뒤 HTML 문서를 조립해 보냅니다. 이 과정에서 플러그인끼리 같은 이름의 함수를 중복 선언하거나, PHP 버전 업그레이드 뒤 구형 플러그인 문법이 호환되지 않아 치명적 오류(PHP Fatal Error) 가 발생하면 서버가 페이지를 그리던 중간에 즉시 실행을 멈추어 빈 화면이 나옵니다.
또한 PHP가 한 번에 사용할 수 있는 허용 메모리 한도(‘memory_limit’)를 무거운 플러그인이나 대량 작업이 초과했을 때도 동일한 백지 오류가 발생하며, 이 오류는 방문자 화면뿐만 아니라 관리자 화면(‘/wp-admin’) 로딩에도 똑같은 PHP 파일들을 불러오기 때문에 관리자 접속까지 함께 마비됩니다.
플러그인 삭제 대신 폴더 이름 변경으로 복구해야 하는 이유
FTP(또는 SFTP)로 서버에 들어갔을 때 가장 흔히 저지르는 실수는 문제가 의심되는 플러그인 폴더나 테마 폴더를 그 자리에서 곧바로 삭제해 버리는 행동입니다. “오류를 일으킨 플러그인을 FTP에서 바로 지워야 사이트가 살아난다”고 급하게 폴더를 지우면, 나중에 해당 플러그인과 연결된 설정이나 커스텀 데이터가 꼬이거나 복구 시 버전을 다시 찾아야 하는 번거로움이 생깁니다.
워드프레스는 데이터베이스에 어떤 플러그인이 켜져 있는지 목록을 저장해 두었다가, 부팅 시 ‘wp-content/plugins’ 경로에서 해당 폴더를 찾지 못하면 자동으로 그 플러그인을 ‘비활성화’ 상태로 안전하게 건너뛰고 사이트를 열어 줍니다. 따라서 삭제가 아니라 폴더 이름 뒤에 ‘_old’나 ‘_off’를 붙여 이름만 변경하는 것이 데이터를 보전하면서 충돌을 우회하는 가장 안전한 복구 원칙입니다.
FTP·SFTP 접속을 통한 플러그인·테마 충돌 4단계 복구 순서
워드프레스 빈 화면 오류로 관리자 페이지에 들어갈 수 없을 때는 호스팅 복구 스냅샷 여부를 확인한 뒤, 아래 순서대로 서버 폴더를 점검해 나갑니다.
FTP·SFTP 워드프레스 빈 화면 복구 4단계 순서
- 1단계 – 전체 플러그인 일시 비활성화(‘plugins’ 이름 변경): FileZilla·WinSCP 같은 FTP/SFTP 클라이언트나 호스팅 관리 패널의 웹 파일 관리자로 워드프레스 설치 루트(‘/wp-content’)에 들어갑니다. 그 안의 ‘plugins’ 폴더 이름을 ‘plugins_old’로 바꾼 뒤 브라우저에서 관리자 페이지(‘/wp-admin’)를 새로고침합니다. 화면이 정상으로 돌아오면 범인은 플러그인 충돌입니다.
- 2단계 – 개별 플러그인 분리로 범인 특정: 사이트가 열렸다면 FTP에서 ‘plugins_old’ 이름을 다시 원래대로 ‘plugins’로 되돌린 다음, 그 내부로 들어가 최근 업데이트·설치한 플러그인 폴더 이름부터 하나씩 ‘_off’를 붙여 봅니다. 관리자 페이지의 ‘플러그인’ 메뉴가 열린 상태에서 하나씩 원상 복구하며 다시 오류를 일으키는 단 하나의 플러그인을 가려냅니다.
- 3단계 – 활성 테마 폴백(Fallback) 점검: 1단계에서 ‘plugins_old’로 바꾸었는데도 여전히 빈 화면이라면 테마(특히 ‘functions.php’ 수정 실수)가 원인입니다. ‘/wp-content/themes/’ 폴더 안으로 들어가 현재 사용 중인 테마 폴더 이름을 ‘테마이름_old’로 바꿉니다. (단, 기본 제공 테마인 ‘twentytwentyfour’ 같은 워드프레스 기본 테마 폴더가 최소 1개 이상 같은 경로에 남아 있어야 워드프레스가 자동으로 기본 테마로 전환해 복구합니다.)
- 4단계 – ‘wp-config.php’ 디버그 로그로 정확한 에러 행 확인: 플러그인과 테마 모두 문제가 아니거나 정확한 오류 원인을 확인해야 한다면, 루트 경로의 ‘wp-config.php’ 파일을 PC로 내려받아 반드시 원본 백업본을 따로 저장한 뒤 수정합니다. 파일 안의 ‘define( ‘WP_DEBUG’, false );’ 부분을 ‘true’로 바꾸고 바로 아래 줄에 ‘define( ‘WP_DEBUG_LOG’, true );’를 추가해 올리면 ‘/wp-content/debug.log’ 파일에 어느 파일 몇 번째 줄에서 Fatal Error가 났는지 기록됩니다. (문제를 고친 뒤에는 보안상 내부 경로 노출을 막기 위해 반드시 다시 ‘false’로 되돌려야 합니다.)
워드프레스 먹통 원인별 증상과 FTP 조치 경로 비교
워드프레스 빈 화면 오류가 생겼을 때 원인 유형에 따른 확인 경로와 복구 기준을 표로 정리했습니다.
| 구분 | 플러그인 간 충돌·PHP 버전 불일치 | 테마 오류·functions.php 오타 | PHP 메모리 한도(‘memory_limit’) 초과 |
|---|---|---|---|
| 주요 발생 계기 | 플러그인 업데이트·신규 설치 직후 | 자식 테마 코드 편집 또는 테마 업데이트 직후 | 페이지 빌더·대용량 이미지·백업 플러그인 실행 시 |
| FTP 점검 경로 | /wp-content/plugins/ | /wp-content/themes/ | 루트 경로 wp-config.php (또는 php.ini) |
| 안전 복구 조치 | 폴더 이름 변경으로 일괄 해제 후 개별 분리 | 현재 테마 폴더 이름 변경해 기본 테마로 전환 | debug.log로 점유 플러그인 확인 후 메모리 상향 |
| 주의 및 확인 사항 | 폴더를 직접 삭제하지 말고 이름만 변경할 것 | themes 안에 기본 테마가 1개 이상 남아 있어야 함 | 원인 해결 후 WP_DEBUG는 반드시 false 복귀 |
핵심 정리
워드프레스 빈 화면 오류가 관리자 페이지까지 가려 버렸을 때 당황해 호스팅을 초기화하거나 FTP에서 폴더를 무작정 삭제할 필요가 없습니다. ‘wp-content/plugins’와 ‘themes’ 폴더 이름 변경만으로 충돌 지점을 우회해 관리자 접속을 되찾고, 필요할 때는 ‘wp-config.php’ 백업 후 ‘WP_DEBUG_LOG’를 잠시 켜서 정확한 에러 위치만 확인한 뒤 닫는 순서가 가장 빠르고 안전한 복구 전략입니다.
재발 방지 체크리스트
재발 방지 체크리스트
- 플러그인이나 테마를 업데이트하기 전에는 호스팅 자동 백업 또는 DB·파일 스냅샷이 최신 상태인지 먼저 확인합니다.
- 테마의 ‘functions.php’나 ‘wp-config.php’ 파일을 수정할 때는 관리자 ‘테마 파일 편집기’ 대신 FTP로 원본을 내려받아 백업본을 남긴 뒤 편집합니다.
- 서버의 PHP 버전을 올릴 때는 사용 중인 핵심 플러그인과 테마가 새 PHP 버전을 공식 지원하는지 미리 점검합니다.
- 원인 파악을 위해 켰던 ‘WP_DEBUG’ 설정과 생성된 ‘debug.log’ 파일은 복구가 끝나자마자 비활성화 및 삭제해 서버 정보 노출을 막습니다.









